Om de paar maanden los ik iets op, voel me even slim, en ben vervolgens alle details weer vergeten. Dit is de oplossing: een kladblok.

Waarom een kladblok, en geen blog

Het etiket doet meer dan het zou moeten. Zodra iets Een Blogpost is, wil ik dat het af is: een nette inleiding, een afgeronde conclusie, een diagram, nog één keer nalezen voordat het online gaat. Voor een uitgebreid artikel is dat een prima maatstaf. Voor “dit is de vlag die het oploste” niet.

Dit een kladblok noemen legt de lat bewust anders, voor wie het leest, en vooral voor mezelf. Een stuk hier mag drie alinea’s zijn met een commando dat toevallig werkte. Het mag informeel zijn, het mag een mening zijn, en het mag volgende maand achterhaald blijken. Niets hoeft het laatste woord over iets te zijn; het moet vooral opgeschreven zijn.

De vorm is dus met opzet vrij. Als een stuk af en toe leest als een aantekening aan mezelf, dan is dat precies de bedoeling.

De techniek, en waarom die saai is

Het idee is dat deze site over vijf jaar nog steeds bouwt zonder dat ik er veel naar hoef om te kijken. Daarmee vielen de meeste leuke opties af.

  • Hugo, één statische binary. Het rendert Markdown naar HTML en verder niets. Het komt binnen via het npm-pakket hugo-extended, dus er is geen aparte toolchain nodig.
  • PaperMod, toegevoegd als Hugo Module in plaats van een gekopieerd thema of een git submodule. Het thema staat vastgezet in go.mod, zodat Renovate het bijwerkt als elke andere dependency.
  • Geen eigen JavaScript. Niets om te bundelen, niets om te patchen.

Dat laatste punt is waar het mij om gaat. Ik heb eerder een Hugo-thema gehad dat niet meer onderhouden werd, en zo’n gekopieerd thema jaren later uit een repository peuteren is geen pretje. Door het thema als dependency te behandelen merk ik het wanneer het stil komt te liggen, in plaats van pas wanneer Hugo een API verandert.

Deployen

Een push naar main start een GitHub Actions-workflow die de site bouwt en wrangler pages deploy uitvoert richting Cloudflare Pages. Pull requests krijgen hun eigen preview-URL, die als reactie op de PR wordt geplaatst.

Wat hier komt te staan

Korte aantekeningen over infrastructuur, security en automatisering, vooral het soort dingen dat ik anders uit een verlopen browsertab moet terugzoeken.