Jekyll generates a complete website such as a blog from plain text files. The generated files can be served by any standard webserver. Markup languages such as Markdown are supported through Gems. Jekyll is made to be compatible with version control systems such as Git. These steps will install Ruby and Jekyll for the current user. Tested on Ubuntu Server 11.10 Oneiric

RVM

The Ruby Version Manager can be used to install the latest version of Ruby on Ubuntu.

Update System

Make sure the system is fully updated. sudo apt-get update && sudo apt-get dist-upgrade

RVM Dependencies

The RVM install script requires CURL sudo apt-get install curl ### RVM Install Script ### The RVM install script will install the stable version of RVM for the current user. After RVM is installed Ruby will automatically be installed.

curl -L get.rvm.io | bash -s stable

Enable RVM commands in the current shell. source ~/.rvm/scripts/rvm

Ruby Dependencies

Use rvm requirements to generate a list of Ruby dependencies. In Ubuntu 11.10 it is:

sudo apt-get install build-essential openssl libreadline6 libreadline6-dev curl git-core zlib1g zlib1g-dev libssl-dev libyaml-dev libsqlite3-dev sqlite3 libxml2-dev libxslt-dev autoconf libc6-dev ncurses-dev automake libtool bison subversion

Ruby

Now use RVM to install the default version of Ruby. rvm install ruby

Test Ruby

ruby -v Should say something like: ruby 1.9.3p194 (2012-04-20 revision 35410) [x86_64-linux]

Jekyll

Install Jekyll

gem install jekyll --no-rdoc --no-ri

Optional

Pygments

Pygments allows syntax highlighting. sudo apt-get install python-pygments

Markdown

Two alternative Markdown renderers are Rdiscount and Kramdown. ### Rdiscount ### gem install rdiscount –no-rdoc –no-ri

Kramdown

gem install kramdown --no-rdoc --no-ri

SASS and rb-inotify

Needed for some themes. gem install sass –no-rdoc –no-ri gem install rb-inotify –no-rdoc –no-ri

Run Jekyll

Jekyll is now installed, and is ready to be used.

Clone Repository

Download the latest copy of your website. Use the URL for your project.

Read-only access to the repository, such as on servers. git clone git://github.com/mchelen/michaelchelen.net.git

Write access to the repository, for when creating and editing web pages. git clone git@github.com:mchelen/michaelchelen.net.git

Start Jekyll

cd michaelchelen.net
jekyll

The website files will be generated in the _site directory. These can be served by any standard webserver such as Apache.

Site settings are stored in the _config.yml file.

These settings can be overriden through the command line. For example the website can be viewed through the Jekyll server using --server instead of another web server. The --auto option will cause the website to be regenerated when any files are edited.

jekyll --server --auto