Home Jekyll
Post
Cancel

Jekyll

Jekyll is a static site generator. It can be used to create a website without a database.

macOS installation (arm64)

1
2
3
4
5
6
7
8
9
10
11
xcode-select --install
brew install rbenv ruby-build
rbenv install 3.1.2
rbenv global 3.1.2
ruby -v
rbenv rehash
echo 'eval "$(rbenv init - zsh)"' >> ~/.zshrc
source ~/.zshrc
gem install jekyll bundler
echo 'export PATH="/usr/local/opt/ruby/bin:/usr/local/lib/ruby/gems/3.1.2/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

You may need to run a rebuild inside the project directory:

1
2
3
bundle update --bundler
bundle add webrick
bundle install --redownload

If you use a github build action, you need to add

1
bundle lock --add-platform x86_64-linux

Linux depemdenices

Arch

1
2
sudo pacman -Syu --noconfirm
sudo pacman -S ruby base-devel --noconfirm

Debian

1
2
sudo apt uptate -y && sudo apt upgrade -y
sudo apt install -y ruby-full build-essential

Fedora

1
2
sudo dnf update -y && sudo dnf upgrade -y
sudo dnf install ruby ruby-devel openssl-devel redhat-rpm-config @development-tools -y

Linux installation

1
2
3
4
5
echo '# Install Ruby Gems to ~/gems' >> ~/.zshrc
echo 'export GEM_HOME="$HOME/gems"' >> ~/.zshrc
echo 'export PATH="$HOME/gems/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
gem install jekyll bundler

Usage

create a new site and run it on localhost:4000

1
2
3
jekyll new my-awesome-site
cd my-awesome-site
bundle exec jekyll serve
This post is licensed under CC BY 4.0 by the author.