As indicated in the documentation, Jekyll does not yet support Windows. Alas, after a couple of hours of searching on Google, I found the correct help, packages, and support tools that will make Jekyll run well on Windows. Note that the whole installation process was done in Windows 7. That’s in case this will not work for any other version of Windows.
Required packages and tools:
- RailsInstaller
- Python 2.7
- ez_setup.py
Download and install Ruby using the RailsInstaller package. You can just use its default installation settings.
Once done, open up Git Bash and install the Jekyll Ruby gem and its dependencies.
gem install jekyllThe installation should be going smoothly. In fact, you can start creating your blog.
jekyll new blogNow, the problem starts when you try to run jekyll serve. This most likely has something to do with the pygment.rb gem.
Note that as per Jekyll documentation pygments.rb requires Python to be installed. That said, download and install first Python 2.7 and add its executable path to Windows PATH environment variable. Then download and run ez_setup.py. You may need re-open Git Bash so that the changes to the Window’s PATH variable will take effect.
python ez_setup.py There will still likely be a problem with pygments.rb which can be solved by installing a lower version of it. So run the following gem commands to replace pygments.rb 0.5.4 with 0.5.0.
gem uninstall pygments.rb 0.5.4
gem install pygments.rb 0.5.0Just recently found out that 0.6.0 already solves this problem as well, so you can install this or the latest instead of 0.5.0.
gem install pygments.rb 0.6.0Verify if everything’s well already by running the jekyll server and opening up http://localhost:4000 in your preferred browser.
jekyll serve
Sources:
