Introduction to Jekyll

Introduction to Jekyll.md

Introduction to Jekyll

1. Prerequisites
   1. Install Xcode
   2. Install Homebrew
   3. Install rbenv and ruby-build
   4. Install Bundler
2. Getting Started
   1. Install Jekyll
   2. [Create new Jekyll Site](#create-new-jekyll site)
   3. Run Jekyll Server
   4. View the Jekyll Website

Prerequisites

Install Xcode

Install Xcode from the App Store. Once installed open to accept the User Agreement. Then install the Xcode Command Line Tools by running xcode-select --install from Terminal.

For more information on Xcode visit https://developer.apple.com/xcode/.

Install Homebrew

Run the following command from Terminal to install Homebrew.

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

For more informaion on Homebrew visit http://brew.sh/.

Install rbenv and ruby-build

Run the following commands one by one from the Terminal.

brew install rbenv ruby-build

echo 'eval "$(rbenv init -)"' >> ~/.bash_profile

source ~/.bash_profile

rbenv install 2.3.0
rbenv global 2.3.0

gem update --system

Note: If ruby 2.3.0 fails to install follow the instructions found here to update ruby-build.

For more information on rbenv visit https://github.com/rbenv/rbenv.

Install Bundler

Run the following command from Terminal to install Bundler.

gem install bundler

For more information on Bundler visit http://bundler.io/.

Getting Started

Run the following command from Terminal to install Jekyll.

Install Jekyll

gem install jekyll

For more information on Jekyll visit https://jekyllrb.com/.

Create new Jekyll Site

Run the following command from Terminal to create a new Jekyll site in the current directory.

jekyll new my-awesome-site

Run Jekyll Server

Change the current directory to the newly created directory in Terminal and then run a Jekyll server with the starter content created by the jekyll new command.

cd my-awesome-site
jekyll serve

View the Jekyll Website

Navigate to http://localhost:4000/ to see the started Jekyll site in action.