A Shitty Static Site Generator
Even though I had been a developer for a long time, I never made much effort to develop tools for myself. Why would I? There is already so much good software out there that you can download for free. Surely it is better to just use that and not waste your time?
Maybe. Maybe not. It depends much on what one considers 'better'. Sometimes better is about the amount of features, or the amount of bugs. But other times it is about the amount of friction in daily use. And nothing beats homegrown software in that last category.
This project started with a rant. Apparently it struck a nerve and was submitted to popular developers communities like hackernews, and lobste.rs.
I used it and used it for about a year and then let it reincarnate in the scripts that generate the site you are reading now. Because that is very easy to do with your own software as well: change it however you want, whenever you like.
Code can be found here.
One would expect a walk through the code of a self proclaimed “shitty” software project not to be a pleasant read. I promise that it is not that bad.
A Tiny Subset of Asciidoc for Blogging
As promised in my earlier post on why I decided to build my own Shitty Static Site Generator, I’ll explain the markup format that I use for the posts on this site.
Why I Built My Own Shitty Static Site Generator
On the internet, there is no shortage of good quality static site generators (SSG’s) that you can download for free. Hugo, Jekyll, and hundreds of others are readily available. And they work. You can build all kinds of sites with them. I know that, because I’ve used some of them.