The transition to Jekyll and GitHub pages

By Dan Liew


After many years of volunteering his time to maintain the UUU website Gavin McGreggor (GKMac) decided to step down from his role as UUU webmaster. Thanks for all your effort GK, we wish you all the best!

It looks like maintaining the website has fallen to me again. With the existing hosting for the UUU website about the expire it was time to look else where.

Given that the UUU no longer hosts a forum and the rest of the content is static I decided it didn’t make much sense to use any server side scripting at all.

Instead I went down the route of using a static site generator. I also decided I’d like to try using GitHub pages for hosting which limited my choice to using Jekyll.

Doing this gives us many advantages

The only real downside is that we can’t have any server side scripting at all (e.g. some sort of submission form). Right now we don’t need it so I’ll keep things how they are.

It was a non-trivial amount of work to port the old website to Jekyll but now that it’s done I think it paves the way for some fun and intersting things we could do.

Guest blogs

Jekyll is designed for blogging and it makes doing so very easy. Just take a look at the code for this blog post. It’s very easy to read because it is written using markdown.

I’m hoping that it’s simple enough that we could have something like monthly (too optimistic?) “guest blog” articles. These could be about anything unicycle related. For example like a recent ride someone went on or a guide to fixing something on your unicycle.

Better handling of club data

Our club data is seperated from its presentation in YAML files. This could let us do some neat things.

Modernise the design

Our website isn’t particularlly pretty but now that we’ve transitioned to Jekyll a lot of the data and presentation have been seperated which should make it fairly simple for us to use a fancy web framework to make our website look pretty. I’m thinking Twitter’s Bootstrap would be a good choice.

Better handling of “Where to ride” data

A feature on the old website not available anymore is locations suitable for riding. We could put these locations into a structured data format (i.e. YAML) like we did for our club data and present this data on the website and also as a JSON API for other websites to pull in.

There is a work in progress here but it’s not anywhere near complete.

Right that’s enough yacking from me. Feel free to comment below.