This post covers my experience establishing a local environment for building and compiling a GitHub-Pages compatible Jekyll site on Windows 10 (64).
A troublesome task?
It’s been said around that setting up a local development environment of Jekyll on Windows is quite troublesome; my experience was not so bad…
This was mostly a CLI experience with Chocolately with the exception of the Ruby DevKit install.
1. Install Ruby
2. Install Ruby DevKit
Navigate to the DevKit folder
Init the DevKit:
Now modify the DevKit config.yml in a text editor by defining the path to your installed Ruby.
Then you can install the devkit
3. Install Jekyll with github-pages compatible gems
Here’s the current dependency list of github-pages compatible Ruby gems.
This installs lots of gems so takes a while…but produced the following satisfying output
49 gems installed
Optional steps for syntax highlighting with Pygments
4. Install Python
and verify install with by querying the version:
5. Install Pygments via EasyInstall
Guided by Yi Zeng - thanks.
and verify EasyInstall by querying the version:
now simply install Pygments:
Test the Jekyll installation
Starting from a theme
TroubleShooting Jekyll Build
At this point in my initial setup I got an error on my first build:
After which I could