In order to run the github-pages that runs on jekyll on your local machine, follow the following steps:

Ruby Install in Windows

  1. First download and install ruby for your platform, say at C:\Ruby23 For windows get from here.

  2. Download and extract the ruby dev-kit at a certain directory, say at C:\Ruby23\dev-kit and run the following cmd as eleveated user.

  3. Initialize the dev-kit

cd C:\\Ruby23\\dev-kit
ruby dk.rb init
  1. Now install the dev-kit
ruby dk.rb install

Ruby Install in CentOS

Install Dependant Library

yum -y install gcc-c++ patch readline readline-devel zlib zlib-devel
yum -y install libyaml-devel libffi-devel openssl-devel make
yum -y install bzip2 autoconf automake libtool bison iconv-devel sqlite-devel

Install RVM

curl -sSL https://rvm.io/mpapis.asc | gpg --import -
curl -L get.rvm.io | bash -s stable

source /etc/profile.d/rvm.sh
rvm reload

rvm install 2.2.4

Install Jekyll gem.

Now install basic gem to get started. Use the following syntax to install gem.

gem install <gem-name> -v <version>
NOTE: Ignore -v to install the latest version.

Using the following gem:

  1. bundle

  2. rake

  3. jekyll

NOTE: For the jekyll check the Jekyll version supported by the github and install it.

Install jekyll plugin.

If you want to use plugins in jekyll refer jekyll doc.

For standard github-pages, put these line inside your Gemfile

source 'http://rubygems.org'
gem 'github-pages', group: :jekyll_plugins

Refer github-pages for more information.

Rakefile

This rake file to ease the creation of post and page. The usage is :

rake post title="Hello World"
or
rake page title="My Page"


Run locally

To see the local build for the site,

bundle exec jekyll serve --incremental