How to fix: Jekyll build/serve error message
We can set up a local version of our Jekyll GitHub Pages website to preview our website before making the changes public. But when I run the
jekyll [build | serve] command it throws the following error message:
Ignoring RedCloth-4.3.0 because its extensions are not built. Try: gem pristine RedCloth --version 4.3.0 Ignoring rdiscount-22.214.171.124 because its extensions are not built. Try: gem pristine rdiscount --version 126.96.36.199 Ignoring redcarpet-3.3.4 because its extensions are not built. Try: gem pristine redcarpet --version 3.3.4 /Library/Ruby/Gems/2.0.0/gems/bundler-1.11.2/lib/bundler/runtime.rb:34:in 'block in setup': You have already activated colorator 1.1.0, but your Gemfile requires colorator 0.1. Prepending 'bundle exec' to your command may solve this. (Gem::LoadError) from /Library/Ruby/Gems/2.0.0/gems/bundler-1.11.2/lib/bundler/runtime.rb:19:in 'setup' from /Library/Ruby/Gems/2.0.0/gems/bundler-1.11.2/lib/bundler.rb:92:in 'setup' from /Library/Ruby/Gems/2.0.0/gems/jekyll-3.2.1/lib/jekyll/plugin_manager.rb:36:in 'require_from_bundler' from /Library/Ruby/Gems/2.0.0/gems/jekyll-3.2.1/exe/jekyll:9:in ''<top (required)>' from /usr/local/bin/jekyll:22:in 'load' from /usr/local/bin/jekyll:22:in '<main>'
What causes this problem
This error message means that we haven’t properly set up the Jekyll dependencies (gems and their versions) in our system. To solve this issue, follow the steps below.
How to solve it
The best way to eliminate these errors is to solve each gems and their versions issues separately. But there is also the easiest way to solve this issue, it’s just use the Bundler.
About: Bundler provides a consistent environment for Ruby projects by tracking and installing the exact gems and versions that are needed. Bundler is an exit from dependency hell, and ensures that the gems you need are present in development, staging, and production. Starting work on a project is as simple as bundle install.
Getting started with Bundler is easy, just run this command:
gem install bundler
and then within the directory of our website, run this:
Finally, we able to build and serve the website locally with the following command:
bundle exec jekyll serve
Now our website was successfully being served locally at
http://127.0.0.1:4000/ using the built-in web server provided by Jekyll.
If you are having trouble fixing this problem with the instructions above, but are being able to solve this problem with any another method please describe it in the comment section below. Thanks!
If this article has helped you solve the problem then please leave a comment
Thanks for reading!
Arthur is a designer and full stack software engineer. He is the founder of Space X-Chimp and the blog My Cyber Universe. His personal website can be found at arthurgareginyan.com.