Skip to content

Jekyll

Jekyll tips and tricks

Tips and tricks to work with Jekyll, from Fedora setup to dependency and bundle issues.

Installing Jekyll on Fedora with rbenv

Before installing rbenv, make sure the development toolchain is present on the system:

sudo dnf groupinstall "Development Tools"
sudo dnf install perl-core zlib-devel

Check GitHub Pages dependency support

If you deploy a Jekyll site on GitHub Pages, always confirm which versions are supported before upgrading gems or changing configuration.

See the GitHub Pages dependency versions page.

Fixing local jekyll serve bundle issues

After changing the Gemfile, local runs can break with messages like:

You have already activated... Consider using bundle exec.

When that happens, these commands usually help:

bundle clean --force
bundle update
bundle install # remove Gemfile.lock before this step