- Install Ruby. I recommend installing to C:\Ruby to avoid having a path with spaces (otherwise you'll get errors later in the setup process).
- Grab the DevKit and extract to somewhere permanent with no spaces in the path (Ex. C:\DevKit). Make sure to get the correct version for your system's architecture (32 or 64 bit).
- Update your system path to include the DevKit build tools (Control Panel > System > Advanced system settings > Environment Variables > [Edit] Path).
- Add the path to both /bin directories like so:
C:\DevKit\bin;C:\DevKit\mingw\bin;otherwise Ruby will throw an error when building native gems.
- Open a terminal (PowerShell recommended in Windows) and cd to the DevKit directory.
ruby dk.rb initto generate the config.yml file.
- In config.yml you need to add the path to your Ruby install like so (yes, with the dash character and forward slash!): - C:/Ruby
ruby dk.rb install
gem install jekyll. This will build some native gems on the fly and should return successful.
jekyll new my-site. This will build a new, default Jekyll site in a new directory called 'my-site'.
- The default .markdown file (located in /my-site/_posts) has a bit of syntax highlighted content. This will break the build process if you don't have pygments.rb installed, although, I have this gem installed and it still throws an error. Remove this bit of code in the default .markdown file for now.
jekyll build. This should build the default site without error after removing the syntax highlighted code mentioned in the previous step.
jekyl servethen go to http://localhost:4000/. You should see the following:
|Jekyll default install|
I hope this helps you get Jekyll up and running!
UpdateTo get everything up and running you need the following versions of software installed:
- Ruby 1.9.3
- Python 2.7
If you're building on Ubuntu you can safely run
sudo apt-get install ruby ruby-devto grab the appropriate versions from the Ubuntu software repos. Python 2.7 is installed by default.