This note is used for you who have already had the basic idea about jekyll and how to create a jekyll site. This note is only for quickly reference.

Useful links

Using docker to run/deploy jekyll

Read this readme. An example is an old version of this site.

Install and run Jekyll on fresh machine


This tut is for macOS 11.0 Big Sur.

# install homebrew
/bin/bash -c "$(curl -fsSL <>)"
brew --version # check version
# install rbenv to mange ruby versions
brew install rbenv ruby-build
# add rbenv to bash
echo 'if which rbenv > /dev/null; then eval "$(rbenv init -)"; fi' >> ~/.zshrc
source ~/.zshrc # refresh bash
# install ruby
rbenv install 3.0.0
rbenv global 3.0.0
# reload the terminal / sessions
ruby -v
# go to some jekyll source codes
install bundler
gem install bundler

# install gems
bundle config set --local path 'vendor/bundle'
bundle install

# serve
bundle exec jekyll serve


# install ruby using rvm
rvm install 3.0.0
rvm --default use 3.0.0

# install bundler
sudo gem install bundler
# clone a jekyll theme
# cd to that theme

# install gems in the theme
bundle install --path vendor/bundle