Getting Started with Jekyll

Quick Start

Jekyll is a simple, extendable, static site generator. You give it text written in your favorite markup language and it churns through layouts to create a static website. Throughout that process you can tweak how you want the site URLs to look, what data gets displayed in the layout, and more.


Ruby 101

Jekyll is written in Ruby. If you’re new to Ruby, this page is to help you get up to speed with some of the terminology.

Gems

A gem is code you can include in Ruby projects. It allows you to package up functionality and share it across other projects or with other people. Gems can perform functionality such as:

  • Converting a Ruby object to JSON
  • Pagination
  • Interacting with APIs such as Github
  • Jekyll itself is a gem as well as many Jekyll plugins including jekyll-feed, jekyll-seo-tag and jekyll-archives.

Gemfile

A Gemfile is a list of gems required for your site. For a simple Jekyll site it might look something like this:

source 'https://rubygems.org'

gem 'jekyll'

group :jekyll_plugins do
  gem 'jekyll-feed'
  gem 'jekyll-seo-tag'
end

Bundler

Bundler installs the gems in your Gemfile. It’s not a requirement for you to use a Gemfile and bundler however it’s highly recommended as it ensures you’re running the same version of Jekyll and Jekyll plugins across different environments.

gem install bundler installs Bundler. You only need to install it once — not every time you create a new Jekyll project. Here are some additional details:

If you’re using a Gemfile you would first run bundle install to install the gems, then bundle exec jekyll serve to build your site. This guarantees you’re using the gem versions set in the Gemfile. If you’re not using a Gemfile you can just run jekyll serve.

For more information about how to use Bundler in your Jekyll project, this tutorial should provide answers to the most common questions and explain how to get up and running quickly.


Instructions

  • Install a full Ruby development environment
  • Install Jekyll and bundler gems
	gem install jekyll bundler
  • Create a new Jekyll site at ./myblog
	jekyll new myblog
  • Change into your new directory
	cd myblog
  • Build the site and make it available on a local server
bundle exec jekyll serve

Installation

Jekyll is a Ruby Gem that can be installed on most systems.

Requirements

  • Ruby version 2.2.5 or above, including all development headers (ruby version can be checked by running ruby -v
  • RubyGemswhich you can check by running gem -v
  • GCC and Makein case your system doesn’t have them installed, which you can check by running gcc -v,g++ -v and make -v in your system’s command line interface.

Guides

For detailed install instructions have a look at the guide for your operating system.

×

Subscribe

The latest tutorials sent straight to your inbox.