Install Jekyll on Windows 7(x86) and Windows 7(x64)

August 22nd, 2015 General 160 views

Jekyll is a command based tool to build simple, blog-aware, static websites.

2 best things about Jekyll are :

  1. Once Jekyll is setup properly on your system, you just need to write your website content in Plain text or using any Markdown editor (e.g. https://stackedit.io/editor) and it will automatically generate pages & blog posts and links on the website. So you don’t need any kind of Admin Panel to maintain web pages.
  2. Jekyll provides features to Host your website for free using Github pages. So all you need is a registered domain name.

But, installing Jekyll on Windows is really not that straight forward. I experienced that recently when I got stuck at various points on my both Windows systems. One contains Windows 7(x86) and the other contains Windows 7(x64). So I decided to get it set up anyhow and prepare the steps so everyone of us get benefited.

Before providing further instructions, I would like to let you all know that I am not a Ruby or Python developer, so I don’t have any deep knowledge to troubleshoot the Ruby gem installations. Below guide it created based on my own experience by following other online tutorials.

Install Jekyll on Windows 7(x86)

1. Download all the necessary tools. Make sure the versions match exactly. As there are lots of conflicts on latest versions. I am also pasting the installer file names so that will be helpful.

Ruby Installer Version 2.1.6
Filename : rubyinstaller-2.1.6.exe
URL : http://rubyinstaller.org/downloads/

Ruby Development Kit Version 4.7.2
Filename : DevKit-mingw64-32-4.7.2-20130224-1151-sfx.exe
URL : http://rubyinstaller.org/downloads/

Python Version 2.7.10
Filename : python-2.7.10.exe
URL : https://www.python.org/downloads/release/python-2710/

2. Install Ruby using Ruby installer and after installation completes, make sure you add the path C:\Ruby21\bin to your Windows environment variable PATH. Reboot your computer after adding path to environment variable.

3. Extract Ruby DevKit to C:\devkit folder. Create a folder if there isn’t any available on that path.

4. Run command prompt and run below commands one by one :

5. Install Python using the downloaded installer and add the path C:\Python27 to your Windows environment variable PATH. Reboot your computer after adding the path to environment variable.

6. Now every required tools are installed and configured properly so we are going to install Jekyll.
Run below command. It will take some time to finish execution of this command as it will fetch each required package from online repository and install it on your system.

7. Test the installation using below commands

If the last line on command prompt is “Server running…”, then keep the command prompt open and browse the url http://127.0.0.1:4000/ in your browser. If it open up a web page with some dummy data related to Jekyll, we are done.

 

Install Jekyll on Windows 7(x64)

1. Download all the necessary tools. Make sure the versions match exactly. As there are lots of conflicts on latest versions. I am also pasting the installer file names so that will be helpful.

Ruby Installer Version 2.0.0
Filename : rubyinstaller-2.0.0-p645-x64.exe
URL : http://rubyinstaller.org/downloads/

Ruby Development Kit Version 4.7.2
Filename : DevKit-mingw64-64-4.7.2-20130224-1432-sfx.exe
URL : http://rubyinstaller.org/downloads/

Python Version 2.7.5
Filename : python-2.7.5.amd64.exe
URL : https://www.python.org/download/releases/2.7.5/

2. Install Ruby using Ruby installer and after installation completes, make sure you add the path C:\Ruby200-x64\bin to your Windows environment variable PATH. Reboot your computer after adding path to environment variable.

3. Extract Ruby DevKit to C:\devkit folder. Create a folder if there isn’t any available on that path.

4. Run command prompt and run below commands one by one :

5. Install Python using the downloaded installer and add the path C:\Python27 to your Windows environment variable PATH. Reboot your computer after adding the path to environment variable.

6. Now every required tools are installed and configured properly so we are going to install Jekyll.
Run below commands. It will take some time to finish execution of every command as it will fetch each required package from online repository and install it on your system.

7. Test the installation using below commands

If the last line on command prompt is “Server running…”, then keep the command prompt and browse the url http://127.0.0.1:4000/ in your browser. If it open up a web page with some dummy data related to Jekyll, we are done.

If you want to know more about Jekyll, follow their quick start guide as that is really easy to follow.

Hope you find it useful, please don’t forget to share it with others.

Leave your comments: