Testing an alternative content style for the ClojureBridge curriculum.
This uses 99% of the existing ClojureBridge curriculum content, however instead of slides we are using Gitbook to provide structure and format of the content.
Using this workshop
Here are a few of the key points to using the content of this workshop.
Navigation with arrow keys
The pages in the workshop can be navigated using the right and left arrow keys, or by pressing the arrows as the side of each page.
Using Klipse for live evaluation
The Klipse live repl is also included in this website to make the code snippets interactive. All code examples and exercises are placed in Klipse code snippets.
(defn live-evaluation [opinion] (str "Klipse live evaluation is... " opinion)) (live-evaluation "awesomenessness")
Exercises are denoted by using the Note callout plugin for gitbook. Exercises look like:
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 to challenges could be included as links to Github Gists, however this requires clicking out of the workshop website (or opening a new tab/window).
To keep answers included directly in the workshop they can be placed in hidden sections. An example of an answer in a hidden section is as follows:
Klipse not rendering in collapse sections
When included Klipse inside a collapse section, the Klipse boxes do not show their content correctly. It would seem the CSS is not evaluated in time before the section is collapsed. If you expand the section and resize the browswer, then klipse will render the content correctly (thats not a great experience).
See the klipse section for examples of this issue.