Install Jekyll on Mavericks

Warning: 该文描述内容已经过时。
{: .notice–danger}

This blog are hosting on Github Pages that based on Jekyll. I’ll write down here my process of installing Jekyll on my macbook laptop since there’s some issues with that.

Command Line Developer Tools

We don’t need to install full XCode any more in mavericks, just install the command line developer tools via terminal: xcode-select --install and follow the instruction.(doesn’t work anymore, download the install file from here.)

Ruby

The new OS X mavericks(10.9.x) ships with Ruby 2.0 already.

Install bundler with:

sudo gem install bundler

Jekyll

I don’t want the Jekyll gems installed into system gem path, So I create a file named Gemfile under my jekyll blog folder with content:

source 'https://rubygems.org'
gem 'github-pages'

then execute bundle install --path vendor/bundle --binstubs. Unfortunately I got the following error:

An error occurred while installing RedCloth (4.2.9), and Bundler cannot continue.
Make sure that `gem install RedCloth -v '4.2.9'` succeeds before bundling. 

It’s seemed there’s no gcc-4.2 in my /usr/bin. The simple solution is just: sudo ln -s /usr/bin/gcc /usr/bin/gcc-4.2.But after that I still got RedCloth building failed. Finally solved this by using the method in this link.

Jekyll Config

Remember to add the exclude option into your _config.yml file:

exclude: ["vendor"]

without that, Jekyll will attemp to compile the file under your gem vendor folder.

Your gitignore

Don’t push the gem stuffs into your git repo, adding these:

.bundle/
vendor/
bin/
Gemfile.lock

Run

See your blog by execute: bundle exec jekyll serve --watch.

Done!