Jekyll to Setup Github Pages

Setup your own blog

Posted by Hanke on December 2, 2020

This is the track for local setup for the github pages.

Before that suppose you already have the github.io local github repository. For Jekyll case , please refer the guideline.

Prepare Env

Install Gem

Install Bundle

1
2
3
sudo gem install bundler
bundle init
sudo gem install -n /usr/local/bin/ jekyll

Error Met

1
2
3
4
5
  Dependency Error: Yikes! It looks like you don't have jekyll-paginate or one of its dependencies installed. In order to use Jekyll as currently configured, you'll need to install this gem. If you've run Jekyll with `bundle exec`, ensure that you have included the jekyll-paginate gem in your Gemfile as well. The full error message from Ruby is: 'cannot load such file -- jekyll-paginate' If you run into trouble, you can find helpful resources at https://jekyllrb.com/help/!
                    ------------------------------------------------
      Jekyll 4.1.1   Please append `--trace` to the `serve` command
                     for any additional information or backtrace.

1
2
3
4
5
6
7
8
9
  Dependency Error: Yikes! It looks like you don't have jekyll-gist or one of its dependencies installed. In order to use Jekyll as currently configured, you'll need to install this gem. If you've run Jekyll with `bundle exec`, ensure that you have included the jekyll-gist gem in your Gemfile as well. The full error message from Ruby is: 'cannot load such file -- jekyll-gist' If you run into trouble, you can find helpful resources at https://jekyllrb.com/help/!
                    ------------------------------------------------
      Jekyll 4.1.1   Please append `--trace` to the `serve` command
                     for any additional information or backtrace.
                    ------------------------------------------------

## Install Dependencies
```bash
gem install jekyll jekyll-gist jekyll-sitemap jekyll-seo-tag

Edit the Local Gemfile

1
2
3
gem "jekyll", "~> 4.1.1"
gem "jekyll-paginate"
gem "jekyll-gist"

Select Theme

Hux Theme

Clone the code and modify the config according to the readme instructions

Run Locally

1
bundle exec jekyll serve

Reference

github jekyll integration guide


Want to see something else added? Open an issue.