• https://github.com/jekyll/jekyll
• http://blog.jetstrap.com/2013/03/building-a-docs-site-with-jekyll-github-pages/
• https://help.github.com/articles/using-jekyll-with-pages
• http://jekyllrb.com/docs/github-pages/
• http://pages.github.com/
• https://help.github.com/articles/creating-project-pages-manually

https://help.github.com/articles/using-jekyll-with-pages#installing-jekyll

1. install Ruby via apt
2. gem install bundler
3. create or checkout a Gemfile and run [sudo] bundle install
4. test using jekyll serve –watch

• Exclude from GitHub
  • _site
• Exlude from Build (set in _config.yml)
  • README.md
  • Gemfile

• Maruku
  • old default -- now deprecated
• Kramdown
  • similar to Maruku
  • default in Jekyll
  • Syntax: Quick or Long
  • Options: documented and defaults in Jekyll
• RedCarpet
  • developed by and for GitHub
  • similar syntax like GitHub, but not exactly the same
    • needs extensions: [smart, autolink, strikethrough, no_intra_emphasis, tables]
  • http://yangsu.github.io/blog/2012/10/11/using-octopress-with-github-flavored-markdown-redcarpet/
  • Extensions
• RDiscount
• Textile
  • http://txstyle.org
  • http://en.wikipedia.org/wiki/Textile_%28markup_language%29

• use page metadata
• use central data object