The latest version of Jekyll at the time of writing is v3.3.0, which is compatible with Windows and requires ruby version >= 2.0.0.
It is not recommended to install versions prior to v3.x due to incompatibilities and breaking changes that were introduced in v3.x. If you are upgrading from an older version please consult this migration guide for details.
Jekyll itself comes in the form of a Ruby Gem, which is an easy-to-install software package. To install Jekyll and all its default dependencies, launch your favorite command line tool and enter the following command.
gem install jekyll bundler
Hit enter, watch, enjoy. This might take a while due to the number of dependencies.
Did you get an SSL_connection error?
If behind a proxy, then you need to specify the proxy address in your gem command like so
gem install --http-proxy http://PROXY.ADDRESS:PORT jekyll bundler
You can specify a username and password as well
gem install --http-proxy http://USER:PASSWORD@PROXY.ADDRESS:PORT jekyll bundler
You can make these settings permanent by setting your
HTTP_PROXY environment variable to the same proxy value.
There are many enhancements available for jekyll sites. Most of them are distributed in the form of GEMs. Below are a few that are most commonly required when installing custom themes:
gem install jekyll-paginate-v2 gem install jekyll-feed gem install jekyll-gist
Tada! You have successfully installed Jekyll. In fact, you can already build and serve sites without errors, unless there are blocks of code in there and you want to use syntax highlighting. To find out how to properly set up one of two syntax highlighters, click on the button below.
Copyright © 2017 Sverrir Sigmundarson, licensed under CC-BY-4.0.