| layout | title |
|---|---|
default |
Developer's Guide |
Please help out by updating this page
It works on Mac OSX. Probably works without any changes or issues on linux. A masochist could probably get it working on Windows.
{% highlight bash }
git clone git://github.com/coffeescript-cookbook/coffeescript-cookbook.github.com.git
{ endhighlight %}
Optional, but highly recommended.
{% highlight bash }
$ rvm gemset create jekyll
$ echo ‘rvm gemset use jekyll’ >> .rvmrc
{ endhighlight %}
{% 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 %}
You’ll need python installed for this. Macs and most linuces come with it preinstalled.
{% highlight bash }
easy_install pygments # for syntax highlighting
{ endhighlight %}
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.
Open another terminal window, cd into the project folder, then cd into the _site subfolder, and run
{% highlight bash }
serve
{ endhighlight %}
This will start a webserver in the _site folder. Open a browser and visit http://localhost:4000/ and you should see the site.
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.