Home How to run Chirpy theme in Jekyll web server on macOS
Post
Cancel

How to run Chirpy theme in Jekyll web server on macOS

Posted 2022-01-11 1 min read

Prerequisites

This tutorial is to install and run the Chirpy theme in Jekyll web server for development. This site could be deployed through Github pages for free using Github actions provided in the source code.

As of 11/1/2021, this tutorial is valid for instances running macOS Monterey (version 12.1 (21C52))

Installation of dependencies

Step 1 - Forking from GitHub

Create a new repository from the Chirpy Starter and name it <GH_USERNAME>.github.io, where GH_USERNAME represents your GitHub username.

Configuration

Update the variables of _config.yml as needed. Some of them are typical options:

  • url
  • avatar
  • timezone
  • lang

Running Local Server

You may want to preview the site contents before publishing, so just run it by first:

Update/install Ruby:

1

brew install ruby

Update/install Jekyll:

1

gem install bundler jekyll

Change the working directory to the github repo, then run:

1

bundle install

Run the local server:

1

bundle exec jekyll s

After a while, the local service will be published at http://127.0.0.1:4000.

Website, Tutorial, Server
This post is licensed under CC BY 4.0 by the author.
Contents