How to add a Jekyll blog to an existing github pages website

I wrote this blog at the Open Science Retreat. Thanks to the organizers for giving me the time and inspiration to finally get this done!

Yesterday I added a blog to my website, because I wanted to write a blog post. I couldn’t find clear instructions for doing this, and I ended up going down several dead ends, so here’s what worked for me.

I already had a website, which was very simple (pretty much just a single html page), but I recently started wanting to write a blog. I’d previously written some things on Medium, but I wanted to move away from using a third party, and I figured “how hard could it be to make one on my website?”. Spoiler: it took some faffing.

Jekyll seemed like a sensible option, so without much further thought I dove in.

I work on Windows, so following these instructions from github, and then these instructions from Jekyll I installed Ruby+Devkit.

Since I already had a clone of my repo locally I could skip straight to point 7 of the github instructions (I’m linking to the web archive version of the instructions, just in case they change):

Then to test my site locally I continued with these instructions and ran: bundle exec jekyll serve. At first it threw an error (cannot load such file -- webrick) which I resolved with bundle add webrick (info here), and then it worked!

Well, it sort of worked, in that it showed my original site, and if I went to it showed a 404…

To tell Jekyll that I wanted to keep my original home page, and that I wanted to have the blog at dannygarside.co.uk/blog I did the following:

And that was all the heavy lifting done! 🎉


I then did a couple of snazzy extra things like:

This post is published under a CC BY 4.0 licence.