` * generated HTML is pretty-printed for easier "view source" * uses deck.js' "swiss" theme and several extensions, including `goto`, `menu`, `navigation`, `status`, `hash`, and `scale` * uses RedCarpet markdown extensions, including * tables * fenced code blocks * mostly backwards-compatible with Showoff, i.e. you can specify a `showoff.json` file on the command line * if the parameter (or 'sections' entry) starts with '# ' then it's parsed as literal markdown, not a file * code syntax highlighting using Coderay * specify language at the top of the block using either ::: or @@@ * e.g. `@@@ ruby` * there's a simple table of contents (click the [toc] link on lower left to toggle) * this is currently very primitive and should be redone and/or integrated into deck.js ## Command-Line API `deck foo.md` * start a local Rack server (probably Sinatra) on port 4333 * http://localhost:4333/ serves the presentation built from `foo.md` * can specify multiple source files in a row * can also specify a showoff.json file to load multiple markdown files ### Options --port, -p : Specify alternate port (default: 4333) --build, -b: Build an HTML file instead of launching a server (WARNING: not very useful yet) --version, -v: Print version and exit --help, -h: Show this message ## Known Issues * If you're running Webrick, you may not be able to kill the server with Ctrl-C. This is a bug in recent versions of Webrick. * Workaround: `gem install thin` -- if thin is installed, deck will use it instead of webrick Report bugs on ## Credits * deck.js by Caleb at * deck.rb by Alex Chaffee , with help from * Steven! Ragnarök ### See Also * [Web Slide Show GGroup](https://groups.google.com/group/webslideshow) * [Showoff](https://github.com/schacon/showoff) by Scott Chacon * [Keydown](https://github.com/infews/keydown) by Davis Frank ## Bugs and Limitations * auxiliary files (e.g. images) are interleaved in URL path space, so overlapping file names might not resolve to the right file * todo: rewrite internal links to files and serve them relative to current dir, not slide dir * H1s (which split slides) are converted to H2s for compatibility with deck.js's CSS themes * unless they're the only item on the slide, in which case they remain H1s * we use RedCarpet to process markdown, which doesn't work exactly the same as RDiscount... for example: * indented code blocks under a bullet point may need to be indented more * code blocks must be separated from the previous text by a newline * slide scaling isn't perfect; sometimes either resizing or reloading will improve the layout ## TODO * fix title tag (base it off of presentation name or something) * scale images to fit on the page * if no files are specified, use either './showoff.json' or all `.md` files under current directory * deck.json config file * config options: * show/hide theme selector * show/hide page number/nav * choose deck extensions * theme * specify which Redcarpet Markdown extensions to use * command-line tool can take a directory * first pass: globs all *.md files in it * command-line options (overriding or complementing config file options) * --output dir * --config deck.json * --theme themename * more slide file types * Erector - `foo/bar_bar.rb` would expect `class BarBar < Deck::Slide` in there * html * slim http://slim-lang.com/index.html * haml * tilt * option to render all JS and CSS inline, for a self-contained HTML doc * `deck --build dir foo.md` * create a self-contained static site inside dir * copies (or inlines) deck.js source, generated html, and axiliary files e.g. images * hell, maybe it should inline everything *including* images (using those base64 urls or whatever) into a single HTML file * build and push into a gh-pages branch * build and push into a heroku app * find any lines that start with a
.(something) and turn them into
* see showoff.rb:189 * some way to build/rebuild a project that is deployable to heroku * PDF * rewrite internal links to files and serve them relative to current dir, not slide dir * custom `.css`, `.scss`, and `.js` files, which will get imported into all slides * support some more extensions https://github.com/imakewebthings/deck.js/wiki * improve table of contents * nested sections * disappear when clicked outside of, esc pressed, etc. * close box ## TODO (community) * submit theme-picker extension to deck.js * mix with keydown https://github.com/infews/keydown * gh-pages documentation site * integrate with slideshow https://github.com/geraldb/slideshow-deck.js * make it a proper Rack middleware thingy and add to https://github.com/rack/rack/wiki/List-of-Middleware # License The MIT License deck.js Copyright (c) 2011 Caleb Troughton deck.rb Copyright (c) 2011-12 Alex Chaffee Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.