README.md in deckrb-0.4.0 vs README.md in deckrb-0.4.1
- old
+ new
@@ -80,9 +80,30 @@
--port, -p <i>: 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
+## 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 can accept either a filename or an array of filenames.)
+
## Known Issues (Bugs and Limitations)
* If you're running Webrick, you may not be able to kill the server with Ctrl-C. This is apparently due to a bug in recent versions of Webrick.
* Workaround: `gem install thin` -- if thin is installed, deck will use it instead of webrick
* auxiliary files (e.g. images) are interleaved in URL path space, so overlapping file names might not resolve to the right file