Implementing a Jekyll Theme on Github.io
TL;DR
Clone the Jekyll theme, base your repository on the clone
Overview
Seems like using a Jekyll theme on GitHub.io should be simple–it is officially supported and there are some excellent looking sites out there. But actually getting it to work proved a bit more annoying than the advertised ‘Repository Settings, Choose a Theme’ as touted.
I am assuming that you are familiar with Git.
Procedure
- Fork the theme using GitHub site
- Rename forked repository to [username].github.io in repository Settings
- Pull repository
- Edit index.md
- Push change(s)
- Check [username].github.io