Skip to content

wilberquito/wilberquito.github.io

Repository files navigation

Chirpy Starter Gem Version GitHub license

Track blog

https://wilberquito.goatcounter.com

Installation

Sign in to GitHub and use this template to generate a brand new repository and name it USERNAME.github.io, where USERNAME represents your GitHub username.

Then clone it to your local machine, and execute the instructions below.

$ bundle

Build the project

$ gem install jekyll bundler

Run project

$ bundle exec jekyll clean
$ bundle exec jekyll build
$ bundle exec jekyll serve

For starters

When installing the Chirpy theme through RubyGems.org, Jekyll can only read files in the folders /_data, /_layouts, /_includes, /_sass and /assets, as well as a small part of options of the /_config.yml file from the theme's gem. If you have ever installed this theme gem, you can use the command bundle info --path jekyll-theme-chirpy to locate these files.

The Jekyll team claims that this is to leave the ball in the user’s court, but this also results in users not being able to enjoy the out-of-the-box experience when using feature-rich themes.

To fully use all the features of Chirpy, you need to copy the other critical files from the theme's gem to your Jekyll site. The following is a list of targets:

.
├── _config.yml
├── _plugins
├── _tabs
└── index.html

To save you time, and also in case you lose some files while copying, we extract those files/configurations of the latest version of the Chirpy theme and the CD workflow to here, so that you can start writing in minutes.

Prerequisites

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

Usage

Please see the theme's docs.

Contributing

The contents of this repository are automatically updated when new releases are made to the main repository. If you have problems using it, or would like to participate in improving it, please go to the main repository for feedback!

License

This work is published under MIT License.