Jekyll Setup

By Amr

Estimated reading time: 1 minutes

Edit on Github
Table of Contents

Jekyll is a static site generator. It takes text written in your favorite markup language and uses layouts to create a static website. You can tweak the site’s look and feel, URLs, the data displayed on the page, and more.

Prerequisites

Jekyll requires the following:

  • Ruby version ** or higher
  • RubyGems
  • GCC and Make

If you want to use Github Pages, here are the dependencies

Instructions

  1. Create a new Jekyll site at ./mysite.
cd ~/github/
jekyll new mysite
  1. Change into your new directory.
    cd mysite
    
  2. Build the site and make it available on a local server.
    bundle exec jekyll serve
    
  3. Browse to http://localhost:4000

If you are using Ruby version 3.0.0 or higher, step 5 may fail. You may fix it by adding webrick to your dependencies: bundle add webrick

Pass the --livereload option to serve to automatically refresh the page with each change you make to the source files: bundle exec jekyll serve --livereload

If you encounter any errors during this process, check that you have installed all the prerequisites in Requirements. If you still have issues, see Troubleshooting.

Installation varies based on your operating system. See our guides for OS-specific instructions.