What is Jekyll?
Jekyll is a blog-aware static site generator powered by Ruby. A static site generator takes a set templates and raw text files, runs it through a converter and renderer, then generates a plain HTML website that’s ready to publish on any web server.
The blog-award part means that blogging is part of Jekyll’s functionality. We can publish and maintain a blog by simply managing a folder of text files.
With Jekyll, we can build a blog, a portfolio, or any website that has a series of post entries without having to depend on a database or content management system. That’s because Jekyll doesn’t require setting up a complex application on a web server like WordPress, Ruby on Rails, or Flask. Instead, all the development magic happens on your computer. When Jekyll is done, it gives you a set of regular web pages that you can upload to any server.
####Jekyll on Windows
While Windows is not an officially-supported platform, it can be used to run Jekyll with the proper tweaks.The installation process is very straight forward.
- Download and install the latest RubyInstaller for your version of Windows. Execute the installer and go through the steps of the installation. When you get to the screen below, make sure to check the “Add Ruby executables to your PATH” box.Click Install and Ruby will be installed within seconds.
- Download the Ruby DevKit matching the version of Ruby you installed.
- When you execute the file, it’ll ask you for a destination for the files. Enter a path that has no spaces in it. Like this:
- Locate the Ruby
2.0.0-p598-x64 folderin the Windows Start Menu and open
Start Command Prompt with Ruby
- Initialize the DevKit and bind it to your Ruby installation. Open your command line tool and navigate to the folder you extracted the DevKit into.
cd C:\RubyDevKitAuto-detect Ruby installations and add them to a configuration file for the next step.
ruby dk.rb initInstall the DevKit, binding it to your Ruby installation.
ruby dk.rb install
To install Jekyll and all its default dependencies, launch your command line tool and enter the following command:
gem install jekyll
Known installation issues
There are currently no reported issues. If you are having one, please report it in the Treehouse forum or feel free to leave a comment below!