AaronEG

16 May 2018

Streamlining the install of Jekyll and Github Pages on Ubuntu on Windows

by aaroneg

Summary

Writing Github pages is pretty easy but it’s annoying having to commit, push and wait to see your changes, or maybe you want to preview the changes locally before everyone else can see them.

The Github help pages are pretty good, but are not optimized for an Ubuntu 16.04 on Windows install.

Install Ubuntu on Windows

It’s very straightforward to install ubuntu on Windows.

Microsoft Documentation

Install Ubuntu packages

These packages are required to allow all the gems to install properly.

sudo apt update && sudo apt install build-essential ruby ruby-dev zlib1g-dev -y

Create your Github Pages repo:

Github Documentation

Run the local server to preview your changes as you make them:

bundle exec jekyll serve
tags: jekyll - github

This site is open source. Improve this page