using-this-workshop.md

Using this workshop

A quick guide to using this workshop.

Navigating the workshop

The pages in the workshop can be navigated using the left-hand menu. To move a page forwards or backwards use the right or left arrow keys, or press the arrows at the side of each page (or bottom of the page if on a small display).

Evaluating Clojure

You can try out Clojure code directly in the pages of this workshop. The code boxes below allow you to edit the code in the top of the box, with the results evaluated automatically and updated in the results in the bottom of the box.

(defn live-evaluation [opinion]
  (str "Clojure live evaluation is... " opinion))

(live-evaluation "awesomenessness")

These code boxes are powered by a ClojureScript library called Klipse.

Hint::Klipse Hints

Alternatively you may use Klipse as a stand-alone editor or as a stand-alone editor with Javascript output

Klipse can evaluate code from a public Github Gists

Exercises

Exercises are denoted by using the Note callout plugin for gitbook. Exercises look like:

Note::Create a Clojure project

Use the Leiningen tool to create a project called clojure-is-awesomenessness

There are other callout styles available, including: Info, Hint, Warning, Tag, Comment, Success, Caution, Quote and Danger.

Answers

Suggested answers are included directly in the workshop in hidden sections. An example of an answer in a hidden section is as follows:

(defn who-has-the-answer [name])
  (str "Only " name " have the answers, allegedly"))

(who-has-the-answers "Smarties")

Cultural reference to an award winning TV advertisement in 1984 that was created using computer graphics.

We do not endorse that anyone has all the answers :)

To get the most out of the workshop you should try to solve the answers first and try several alternative approaches to solving each exercise.