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

• Jemoji cheat sheet.
• Link to post / page.
• Jekyll cheat sheet.
• Rouge CSS file theme (Pygment)
• Compress HTML in Jekyll.
• Kramdown quickref.
• Official dependencies / gems supported by Github Pages.

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

MacOS

This tut is for macOS 11.0 Big Sur.

# install homebrew
/bin/bash -c "$(curl -fsSL <https://raw.githubusercontent.com/Homebrew/install/master/install.sh>)"
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

Ubuntu

• Install rvm (ruby version manager)

# 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