This post is a short tutorial on setting up a static Jekyll blog using GitHub pages.
Install Jekyll
Intructions for installing Jekyll can be found here: https://jekyllrb.com
MacOS X Install Instructions
- Download XCode via App Store – Search for ‘Xcode’ and click install.
- In the latest version of XCode the Command Line tools will be atomically installed
- On the terminal run gem install jekyll bundler
Setting up Hyde
We will be using an updated version of the Hyde template for Jekyll called Hydeout
On the command line, clone the Hydeout template into a new directory using git clone https://github.com/fongandrew/hydeout
Move into this directory and run
1 2 |
bundle install jekyll serve |
You will now have a working Hydeout blog running locally on your machine.
Setting up GitHub Pages
The following assumes you are using the master branch for your blog.
Repoint the Hydeout template to your personal git repo
1 |
git remote set-url origin https://<github url of your new blog>.git |
Push your changes to this repo.
In GitHub:
- Go to the Settings of your Project
- Go to GitHub pages
- Set Source to be your master branch
- Wait 30 seconds or so before trying to load your new website.
Updating a post
- Ensure your local repo is up-to-date using git pull
- Create a new Markdown post under the _post directory
- Run jekyll serve to test your post looks the way you want
- Add, Commit and Push your changes to master
- Your new post will now appear on the website