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 Ruby

# 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