This post reflects the state of the site in May 2020 and may not reflect the present-day design.
Generating The Definition
I’ll try to keep this blog post brief… at least, much more than usual. There were three static site generators that caught my eye, and I ended up going with Jekyll.
Before we continue, let’s define what these pieces of software are first.
A static site generator takes Markdown files and uses HTML templating software to create a static website. This may be a bit reductive, but I like to think of Markdown as the YAML of web development.
While I was impressed with Hugo and Zola, I wanted to avoid as much hassle as possible in deployment. I had successful builds and tried many beautiful themes with the other two generators, but having as little friction as possible when deploying my site was my most important requirement.
This site is hosted on GitHub Pages, which supports Jekyll by default.
There’s no need to maintain a
gh-pages branch or any kind of build workflow.
Despite Jekyll’s major advantage there, two big things stuck out to me when using Hugo and Zola.
- Using GitHub Actions made deployment much easier than the last time I tried a different site generator.
- Since my two favorite languages are (currently) Go and Rust, understanding how the generators worked was much easier.
If I explore self-hosting, change my host provider, or GitHub Pages adopts a new default generator, then I may try Hugo and Zola again. For now, I’m sticking with Jekyll.
There really wasn’t a theme battle. I pretty much saw the Type theme in a sea of Jekyll themes and loved it immediately.
For my website, I mostly require the following:
- The blog posts themselves.
- Access to social meda links.
- Ability to create and link informational pages, like “about”.
- A great light theme.
Yes, I’m serious. Light theme everything.
Type delievered on all those fronts, really well.
I’m thankful for rohanchandra and all of the other contributors that make things like Jekyll and Type possible. Blogging is easy, fun, and efficient when creating a site with GitHub Pages and a static site generator. I highly recommend trying it out!
Huh. I guess this was actually a short post, for once.