deck.rb

slides in markdown, using deck.js

Home: github.com/alexch/deck.rb

Installation

gem install deckrb

Usage

Put this in a file named meals.md:

# Breakfast
* scrambled eggs
* coffee
* bacon

# Lunch
## Ham Sandwich
## Caesar Salad

<!SLIDE>
![a picture of my lunch](ham-sandwich.jpg)

# Dinner
> "To eat is to live." -Anon.
<!VIDEO u1zgFlCw8Aw>

then run this:

deck meals.md

and you’ll get a web server running on http://localhost:4333 serving up a slide presentation with four slides:

Details

deck.js is a JavaScript library for building slide presentations using HTML 5. deck.rb builds on top of deck.js, adding some features:

Command-Line API

deck foo.md

Options

        --port, -p <i>:   Specify alternate port (default: 4333)
           --build, -b:   Build an HTML file instead of launching a server (WARNING: not very useful yet)
       --style, -s <s>:   Specify the style theme from deck.js/themes/style/ (default: swiss)
  --transition, -t <s>:   Specify the transition theme from deck.js/themes/transition/ (default: horizontal-slide)
         --version, -v:   Print version and exit
            --help, -h:   Show this message

Themes

deck.js has several themes for styling and animating your presentation. You can select these from the command line or from a showoff.json file with the style and transition options. Currently the following themes are available:

Style Themes

Transition Themes

Deploying to Heroku

To deploy your slides as a Heroku app, put them into a Git repo, and add a file called config.ru with contents like this:

require "rubygems"
require "bundler"
Bundler.setup
Bundler.require

require 'deck/rack_app'
run Deck::RackApp.build('slides.md')

and a Gemfile like this:

gem "deckrb"

Then deploy to Heroku as usual (e.g. heroku apps:create).

Note that Deck::RackApp.build can accept either a filename or an array of filenames. It also accepts options, e.g.

run Deck::RackApp.build('slides.md', transition: 'fade')

Known Issues (Bugs and Limitations)

Report bugs on github.com/alexch/deck.rb/issues

Credits

See Also

TODO

TODO (community)

License

The MIT License

deck.js Copyright © 2011 Caleb Troughton

deck.rb Copyright © 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.