How To Setup Ruby & Jekyll

On: April 04, 2023


In this post you will learn how to setup Ruby and Jekyll on your Linux server in order to use this theme. I use Ubuntu Linux so I will walk you through setting up on that system. First you need to run:

sudo apt-get install ruby-full build-essential zlib1g-dev

Avoid installing RubyGems packages (called gems) as the root user. Instead, set up a gem installation directory for your user account. The following commands will add environment variables to your ~/.bashrc file to configure the gem installation path:

echo '# Install Ruby Gems to ~/gems' >> ~/.bashrc
echo 'export GEM_HOME="$HOME/gems"' >> ~/.bashrc
echo 'export PATH="$HOME/gems/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Finally, install Jekyll and Bundler:

gem install jekyll bundler

That’s it! You’re ready to start using Jekyll. Read the next guide to learn “How To Configure Your Site _config.yml”


Categories

These can be enabled by uncommenting the section in the config file. You can then link to the category and the user will see all posts on the blog with categories in the front matter.

Jekyll Starter Guides

Read more detailed instructions and documentation on using or contributing to Jekyllgems themes and plugins on my blog. These posts will also ship with your theme / template so you can read them on your own site.