Saturday, February 26, 2011

Using Jekyll, Hyde and Heroku for presentation slides

I was sharing architecture of a RU05 program and performance tuning we did on with Mongo.
Codeaholics Feb Meetup


The slides i showed was actually a web page moving like a powerpoint slides.
The source code to generate the slides is available in github.


here I draft out high level steps giving you some rough ideas of the work required to create such webpage. you can find all the detail steps in jekyll, jekyll_and_hyde and rack-jekyll github page.


install required gems and create project:

gem install jekyll
gem install jekyll_and_hyde
gem install rack-jekyll
jh new codeaholics_hk_feb_2011
cd codeaholics_hk_feb_2011

To prepare deployment for the future, generate the static pages into another folder instead of default _site directory. i used "pages" folder in my case:

in the .gems file, include rack-jekyll
follow the github pages to setup _config.yml and config.ru

You can start creating your powerpoint, and read it at localhost:4000

jekyll --server pages
jh generate frontpage
... // generate your static pages
... // keep your jekyll server running until you finish. i explain why below

When you want to deploy to heroku:

git init
git add .
git commit -m ""
heroku create codeaholics_hk_feb_2011
git push heroku master

One issue i saw when generating post was that. I edited my posts markdown files after I stopped the jekyll server, and later when i started it again, no more static pages generated automatically. I guess the service could no longer recognizes which files was edited. I could not resolve this problem. So, i have to create another project and copy over my markdown files to continue.

1 comment:

  1. If you deploy to GitHub, it already has jekyll running and you can access you slides immediately your deployment, http://pages.github.com/

    ReplyDelete