Jekyll is simple static site generator that focuses on blogs, but can be used for all kinds of sites. It takes html templates and posts written in Markdown to generate static website which is ready to deploy on your favorite web server. Alternatively you can host it on GitHub and publish it via GitHub Pages, absolutely for free.
I use Jekyll for my blog. And official instruction doesn’t enough for me. I got some issues, really small things, and the most one is a Jekyll error. Trying to install Jekyll on the new machine, I got a error.
I need some package installed because some version of ruby binary are not available for Fedora.
In this article I use next version of installed components:
- Fedora 30
- ruby 2.6.3p62 (2019-04-16 revision 67580)
I install next packages manually. It will pretty enough to install Jekyll.
sudo dnf install ruby ruby-devel rubygems-devel \ autoconf automake bison gcc-c++ libffi-devel libtool \ libyaml-devel readline-devel sqlite-devel zlib-devel \ openssl-devel redhat-rpm-config rubygem-nokogiri
So I am not sure that all of them are needed.
Update all system gems
sudo gem install rubygems-update
Then run it
sudo gem update --system
or (if previous not work)
sudo gem update --system --install-dir=/usr/share/gems --bindir /usr/local/bin
Next, install gems for Jekyll and Bundler
sudo gem install jekyll bundler
Done! You may install new Jekyll site and test it locally :)
Inside Jekyll project directory, run
bundler install and
bundler update --bundler
to install and update the gems needed, then use
bundle exec jekyll serve -d public --incremental --verbose --watch to run Jekyll on localhost. If success open URL:localhost:4000 in browser.
- Getting started with GitHub Pages - Host a static site on GitHub.
- Quickstart in Jekyll - Let’s begin design your static site with Jekyll.
- Jekyll, rvm, bundler and Fedora- The article that I inspired by.
- Jekyll on Fedora - Jekyll instruction from Fedora developers.
- minimal-mistakes - The best theme for Jekyll that I’ve try. It is used in this blog.