Switch branches/tags
Nothing to show
Find file
Fetching contributors…
Cannot retrieve contributors at this time
75 lines (46 sloc) 1.96 KB
layout title
Developer's Guide

Developer’s Guide

Please help out by updating this page

Operating System

It works on Mac OSX. Probably works without any changes or issues on linux. A masochist could probably get it working on Windows.


Clone the repo

{% highlight bash }
git clone git://
{ endhighlight %}

Create a Ruby Gemset

Optional, but highly recommended.

{% highlight bash }
$ rvm gemset create jekyll
$ echo ‘rvm gemset use jekyll’ >> .rvmrc
{ endhighlight %}

Install Required Gems

{% highlight bash }
gem install jekyll # needed for testing building the site
gem install RedCloth # needed for .textile rendering
gem install serve # needed for resolving .html files w/o extension
gem install thin # optional; more efficient webserver than Webrick but not strictly necessary
{ endhighlight %}

Install pygments

You’ll need python installed for this. Macs and most linuces come with it preinstalled.

{% highlight bash }
easy_install pygments # for syntax highlighting
{ endhighlight %}

Building and Viewing the Website

Run jekyll

Open a terminal window, cd into the project folder and run jekyll from the project root.

{% highlight bash }
jekyll —auto
{ endhighlight %}

Leave this window running while you work. Any time you change a file, jekyll will rerender it into the _site folder.

Run serve

Open another terminal window, cd into the project folder, then cd into the _site subfolder, and run

{% highlight bash }
{ endhighlight %}

This will start a webserver in the _site folder. Open a browser and visit http://localhost:4000/ and you should see the site.

Minituiae and Other Trivialities

jekyll can take a second or two to catch up when you save a file. If you edit a file and don’t see the changes in your browser, give it a second or two and try again.