Jekyll is a website generator which transforms pain text into static websites. Although officially unsupported Jekyll run well on Windows. The following software packages are needed:

Ruby does not like folder names that contain spaces. Therefore you need to use its 8dot3 file name if you want to install it in %ProgramFiles%. To find a 8dot3 file name just open Command Prompt and type dir /X which inserts the short name before the long name. This is a good choice for Python, too.

C:\>dir /X
 Volume in drive C has no label.

 Directory of C:\

22.08.2013  09:16                24              autoexec.bat
22.08.2013  09:16                10              config.sys
19.11.2013  08:43    <DIR>                       Install
22.08.2013  08:50    <DIR>                       PerfLogs
14.12.2013  20:18    <DIR>          PROGRA~1     Program Files
18.11.2013  16:50    <DIR>                       Users
10.12.2013  22:09    <DIR>                       Windows
               2 File(s)             34 bytes
               5 Dir(s)

To install Jekyll proceed as follows:

  1. Install Ruby as administrator. Check the Add Ruby executables to your PATH option.

  2. Install Python. Add the Python executables to Path. To do this search for View advanced system settings

    Search for Advanced System Settings

    or go to Settings > Control Panel > System and Security > System > Advanced system settings.

    Advanced System Settings

    Then click on Environment Variables… and add Python’s path to the Path system variable.

    Environment Variables

    Path will then look like …;C:\PROGRA~1\Ruby193\bin;C:\PROGRA~1\Python27.

  3. To install the Ruby Development Kit, Easy Setup, Pygments and Jekyll extract the archives, search Command Prompt

    Search for Command Prompt

    or open it via start menu

    Run Command Prompt

    and run it as administratorand . Then execute

    C:\Install\Jekyll\DevKit>ruby dk.rb init
    C:\Install\Jekyll\DevKit>ruby dk.rb install
    C:\Install\Jekyll\DevKit>cd ..\ez_setup-0.9
    C:\Install\Jekyll\ez_setup-0.9>python distribute_setup.py
    C:\Install\Jekyll\ez_setup-0.9>cd \PROGRA~1\Python27\Scripts
    C:\PROGRA~1\Python27\Scripts>easy_install Pygments
    C:\PROGRA~1\Python27\Scripts>gem install jekyll wdm
  4. Finally create a folder for Jekyll in your preferred working directory and create your first site

    C:\Users\...\Documents\Jekyll>jekyll new new-site
    C:\Users\...\Documents\Jekyll>cd new-site
    C:\Users\...\Documents\Jekyll\new-site>jekyll server --watch

    Open http://localhost:4000/ to get a preview.

    Alt text

  5. Refer to documentation for further information.

There is also a portable Jekyll for Windows. With more than 1 GB it is not really a light weight.