Desired Persona

Install Jekyll on macOS Mojave

· 1 min read

Jekyll is a tool for transforming your plain text into static websites and blogs. It is simple, static, and blog-aware. Jekyll uses the Liquid templating language and has built-in Markdown and Textile support. It also ties in nicely to Github Pages so you have the option to host your website for free. I highly recommend you join Jekyll Talk the official support forum, where users and contributors can ask questions and discuss all aspects of Jekyll.

Preparing to install Jekyll

Installing Jekyll is easy and straight-forward, but there are a few requirements you’ll need to make sure your system has before you start.

  1. Go to the Mac app store and Install Xcode.

  2. Install the Xcode Command Line Tools using your Terminal app.
    xcode-select --install
    
  3. Install Homebrew a package manager for macOS.

    Why?

    We will use Homebrew to install Ruby.

    Why macOS already comes with a version of Ruby?

    A lot of the system directories in macOS are locked down making it unusable.

    Install Homebrew using the following command in Terminal app.

     /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
    
  4. Install the latest version of Ruby using Homebrew.
    brew install ruby
    
  5. Check the Ruby version to confirm a successful installation.
    ruby -v
    

Installing Jekyll

  1. Install Bundler. Bundler provides a consistent environment for Ruby projects by tracking and installing the exact gems and versions that are needed.
    gem install bundler
    
  2. Finally you can install Jekyll.
    gem install jekyll
    
  3. Check the Jekyll version.
    jekyll -v
    

    Done!

How to update Jekyll

Bundler will update all your gems to the latest versions by simply running bundle update in a Terminal window.

Did you find this tutorial helpful?