2 ms·
That doesn't sound very boring. That sounds like it has several unnecessary moving parts. Makefiles (and the binaries they run to actually do all the heavy li
by cxr 4y ago
That doesn't sound very boring. That sounds like it has several unnecessary moving parts. Makefiles (and the binaries they run to actually do all the heavy lifting) tend to be more fragile and less portable than their advocates let on. I often come across repos where I don't/can't trust the Makefile finish to completion without error, so I end up cracking it open to see what it's trying to do and then just running those commands manually.
People also inevitably end up forgetting how to use their static site generator setup. (Even in your "boring" example with "just" make, you will perhaps forget the templating language.) A ripe case fit for field study: <https://web.archive.org/web/20210331182731/https://corytheboyd.com/posts/2020-03-09 https://web.archive.org/web/20210331182731/https://corythebo...>
> So, time to update the website, but the first wall I hit was that I: ¶1. Forgot how my over-engineered SaaS was supposed to be used (no documentation because I built it myself and was lazy) ¶2. Forgot how to follow the esoteric Hugo conventions (has documentation, but it's not easy to parse at a glance)
> I was pretty annoyed with myself for having fallen for the trap of not documenting my own systems, but not sure how I could have remembered all of the Hugo-isms, especially since I don't update this site very often and don't do static site generator work outside of this.
If think you want to use a static site generator, first try just making your site capable of self-replication. Write a document that lists all the transformation steps that should be applied to the input in order to produce the desired output, save that as something like makesite.html, dump it somewhere on your site, and have it so that when you drag and drop the directory containing your site sources onto the page, then it spits the publishable version back out. (Just make it so that your makesite.html is written for a dumb enough audience that your computer (read: Web browser) can follow the steps on its own.)
Alternatively, don't use a static site generator. Adopt a regimen where the publishable representation (what would be the SSG's output) is also the canonical representation (i.e. "source").