How to build a Jekyll + GitHub Pages site

This site is built using Jekyll that turns the Markdown and HTML templates into a themed static site. To run Jekyll, install the Ruby via the Ruby Version Manager and install the github-pages Gem (a Ruby package) via Bundler. Installing the github-pages Gem will install the Jekyll executable.

Step 1: install Ruby with the Ruby Version Manager (RVM):

There are too many ways to install Ruby. If you (like me) don’t know anything about Ruby then just install Ruby with RVM.

Make sure you install the version of ruby (via rvm install) compatible with GitHub Pages. Set the current (and default) ruby installation to the compatible version via rvm alias create default <version>.

Step 2: install dependencies, build and serve the site

Follow the github.com instructions.

tl;dr:

Troubleshooting: