Jekyll/Old Crap

This page covers my adventure in getting a Jekyll site set up.

My intent in using Jekyll was to set up a site that would host a pile of Markdown files that compose the contents of a book. Thus, the site is mainly content, and not many blog posts.

I'm writing up my procedure in the spirit of this thread: https://github.com/jekyll/jekyll/issues/1650

Creating Jekyll Site

Here's the basics of setting up a Jekyll site in a Github repository.

Also see here: https://help.github.com/articles/using-jekyll-with-pages

Installing Ruby

First thing you'll need is a computer with a version of ruby on it.

Installing Ruby on Mac OS X

To install Ruby on Mac OS X, I had to first install ruby-build, then install rbenv.

One way to install these is using Homebrew:

brew install ruby-build rbenv

Alternatively, you can use sstephenson's Github projects, ruby-build and rbenv:

• rbenv: https://github.com/sstephenson/rbenv - this project helps you manage Ruby installations
• ruby-build: https://github.com/sstephenson/ruby-build - this project helps you build Ruby

git clone https://github.com/sstephenson/rbenv.git ~/.rbenv
echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bash_profile
echo 'eval "$(rbenv init -)"' >> ~/.bash_profile

then start a new shell and make sure this command prints a function:

type rbenv

Now install ruby-build as a plugin to rbenv:

git clone https://github.com/sstephenson/ruby-build.git ~/.rbenv/plugins/ruby-build

Finally, you can install a version of Ruby:

$ rbenv install -l # list all available versions
$ rbenv install 2.0.0-p247 # install a particular version

Once you've installed Ruby, you can move on to installing Jekyll.