How to make your blog more Blazingly Fast™

Contents:

Hello there reader 👋!

# A little introduction

I am Stijn A.K.A the TeaDrinkingProgrammer and you are currently reading the first blog post on my new blog! On this blog you are probably going to see posts about one of my main interests: cultures and languages, music and programming. The main content is probably going to be programming related, but some cross-overs are possible. In the programming space, I mainly follow developments in the FOSS space (I am writing this on Zettlr and Fedora Linux) and I sometimes play around with new technologies that interest me, like Rust or Svelte.

# Yet Another Blog

So why a blog? Isn’t everyone and their dog making a blog nowadays? Yes, that’s true. I mainly view the blog as an exercise in writing and web development, and a way to share my passions. I’ve actually had the idea for a while, but didn’t have much to write about, until I made a very long comment on Tildes. I realised this comment would make for a good blogpost so now I had motivation and an excuse! I first thought that Medium would work well enough for me, until I found out that:

  1. It has no native Markdown support
  2. It will sometimes ask users to log in to read a post

Medium not having Markdown is not a dealbreaker perse, but it isn’t great. The final straw was Medium nagging users to log in to read posts. I hate when websites do this so that made the decision final: I would try hosting my own website. Besides: it’s a great excuse to figure out how to host a blog and learn some new tech 😄.

I had already thought about how to go about hosting a blog. I already decided early on I was going to use a static-site generator. Not just because it is the obvious choice, but also because I had the “don’t flip the web-pyramid” mentality from the maker of Tildes in the back of my mind.

I had also heard about github.io being a good option for hosting small websites, and it indeed seemed like the perfect fit: simple, free and no buts or ifs.

# Choice Paralysis

But now the age-old question: which of the 9000 static-site generators am I going to use? As I said, I wanted to use this project as an excuse to try out something new, and I have been experimenting with Rust for a while now, so why not (Re)write It In Rust™️. I started looking around for a static website generator in Rust, but didn’t have to look for long. I found Zola and it looked like the right tool for the job: no bloat, easy to use, generates plain HTML and CSS while still allowing me to write in my beloved Markdown, and last but not least: it’s Blazingly Fast ™️. Besides this, the documentation is top-notch and the configuration is great, which it has in common with most Rust projects. As an added bonus, there were a lot of themes to choose from. Sufficed to say: I didn’t look any further.

As for the theme: I ended up choosing Serene, because it strikes the right balance for me: simplistic, but not too simplistic. I like a lightweight website as much as the next guy, but a bit of CSS for a nice look and feel is a sacrifice I am willing to make.

I didn’t change much about the theme. I only swapped out the font. This is because it uses a font from Google Fonts by default, and I block those using a plugin because I don’t really trust Google. Under the motto of the golden rule, I swapped out the font with one from a non-Google provider.

After I had configured everything and filled in the first pages, the website was really coming together. There was one last thing to do: the deployment.

# Deployment

This was surprisingly easy to do: there was already a plug-and-play Github Action! It takes your Github repo, runs zola build in a Docker container and posts puts the result on the gh-pages branch. The only thing you have to, is change the branch setting in the Github Pages settings and voila: a blog has been born!

Remember I said I didn’t tweak much about the theme? Well, I ended up going down a CSS rabbit-hole because my username is so long it breaks mobile 😐. It reminded me of why I hate working with raw CSS, especially padding. But, in the end I figured out a simple fix and it looks quite good if I say so myself.

# Conclusion

So, that’s it then. It took me a while to write this post, so the Tildes post will have to wait 😅, so say tuned. To see what the source code looks like, you can take a look on my Github (Serene theme fork). If everything works as intended 🤞, there should be a RSS feed, so feel free to subscribe to that if you would like to be updated when I post something else.

Otherwise, thank you for taking the time to read my blogpost!

PS: These were the songs I was listening to during the making of this post.

Vulfpeck Live at Bonaroo

Vulfpeck Live at Madison Square Garden

Joni Mitchell Shadows And Light

The Fearless Flyers Live in Europe

Note to self: I listen to a lot of live albums.


Did you like this blogpost? Then consider subscribing via email or RSS. The email newsletter uses Buttondown, which does not track you.