First, lets establish why this project exists:
deck.js is a wonderful library for creating web presentations. Does just enough, and has plugin support. Brilliant.
The Jade templating engine is very expressive and is likely to save you from typing html tags again and again and, um, again.
The two combined with some tooling would be awesome.
NOTE: Deckem uses a modified version of deck.js which removes a lot of the iframe hacks that have been implemented to improve the behaviour of video embedded in slides. This has been done as deckem is designed to be a coders presentation tool and iframes are used to embed demos that have been built with demogen.
First, I'd recommend installing using npm:
npm install deckem -g
This will install the helpful
deckem command-line tool. You should now be able to scaffold a new deck. Change to the directory you want to create the deck in and run the following command:
All being well, you'll end up with a new
main.jade file. Something similar to the one shown below:
In the same directory that you scaffolded your deck, run the following command:
After building your deck (note, you can also just run
deckem as build is the default action), you will have an additional three files in your directory:
In addition to the main
deck.jade file, you might have also noticed that a scaffolded presentation also contains a
deck.json file. This file allows you to configure aspects of the deck.
"title": "Your Deck Title""theme": "neon"
In short, run the
deckem from a directory in which you have subfolders with decks in them. It will build them all for you and put the client assets in the root folder only.
Deck configurations are inherited from parent folders down into subfolders, so you can specify a theme in a top level folder and have all child decks use that them while using the configuration file to set the presentation title.