Install Ruby/DevKit + Jekyll on Windows

gistfile1.md

Install Ruby 2.1.5

1. Install Ruby 2.1.5 for Windows (x64) from RubyInstaller.org.

   • Set Install Tcl/Tk support.
   • Set Add Ruby executables to your path
   • Set Associate .rb and .rbw files with this Ruby installation.
   • Do NOT include whitespaces in the destination folder.

2. Run ruby -v to verify command line access and version.

Update Ruby Certs

1. Run gem install [anygem] to verify you can install gems.

2. If SSL error, update Ruby certs per SSL upgrades on rubygems.org and RubyInstaller versions.

Install the Ruby DevKit

1. Follow the DevKit install instructions.

2. Download the Ruby 2.1 version of the DevKit from the RubyInstaller Downloads page.

3. Extract the files to a local folder without spaces. This should be the permanent location for the DevKit, not a temporary extraction folder.

4. Open a command prompt within the DevKit folder you created in the previous step.

5. Run dk.rb init to generate a _config.yaml file we'll use in a bit.

6. Run dk.rb review to validate the _config.yaml file.

7. If you get an error about an invalid _config.yaml, which you should if you're running the above version(s), make the changes described in this StackOverflow answer.

8. Run dk.rb init and dk.rb review again to verify.

9. Verify your DevKit installation with gem install json --platform=ruby. You should see "native extensions" messages and no errors.

Install Jekyll

1. Run gem install jekyll.

When all else fails...

1. Julian Thilo: Run Jekyll on Windows
2. Madhur Ahuja: PortableJekyll