Getting Started

Prerequisites

Follow the instructions in the Jekyll Docs to complete the installation of the basic environment. Git also needs to be installed.

Installation

Creating a New Site

There are two ways to create a new repository for this theme:

• Using the Chirpy Starter - Easy to upgrade, isolates irrelevant project files so you can focus on writing.
• GitHub Fork - Convenient for custom development, but difficult to upgrade. Unless you are familiar with Jekyll and are determined to tweak or contribute to this project, this approach is not recommended.

Option 1. Using the Chirpy Starter

Sign in to GitHub and browse to Chirpy Starter, click the button Use this template > Create a new repository, and name the new repository USERNAME.github.io, where USERNAME represents your GitHub username.

Option 2. GitHub Fork

Sign in to GitHub to fork Chirpy, and then rename it to USERNAME.github.io (USERNAME means your username).

Next, clone your site to local machine. In order of priority, the --depth 1 option can be specified:

git clone https://github.com/USERNAME/USERNAME.github.io.git --depth 1

Installing Dependencies

Before running local server for the first time, go to the root directory of your site and run:

bundle