Add the motorino generator #3

Merged
squid merged 13 commits from feat/generator into main 2026-11-15 09:04:38 +00:00
Owner

I'm adding motorino, the generator of kmalloc.org, written in Go.

  • Reads a site folder (site.json, lang/*.json, content/<lang>/**/*.md, news/*.md, templates/, static/) and writes plain HTML, all or nothing.
  • Pages and news start with a Key: value header ended by a - line, then Markdown with raw HTML allowed. News are published as /news/YYYY/MM/name.html, with a page for every category and a feed.
  • Headings can set their id with {#id}; a page can say which manifesto version it translates.
  • One dependency (goldmark), make check runs gofmt, vet, staticcheck and the tests.

I checked it by building the real site with it and with the Python generator and comparing the two page by page (17 of 17 identical), and with the Nu HTML Checker (no messages). A review of the whole branch found one regression (a quote in a title broke og:title) and three robustness issues (clashing output addresses, unsafe asset paths and language codes, the Switch key); all four are fixed with tests. The minor findings are in #2.

Closes #1

I'm adding motorino, the generator of kmalloc.org, written in Go. - Reads a site folder (`site.json`, `lang/*.json`, `content/<lang>/**/*.md`, `news/*.md`, `templates/`, `static/`) and writes plain HTML, all or nothing. - Pages and news start with a `Key: value` header ended by a `-` line, then Markdown with raw HTML allowed. News are published as `/news/YYYY/MM/name.html`, with a page for every category and a feed. - Headings can set their id with `{#id}`; a page can say which manifesto version it translates. - One dependency (goldmark), `make check` runs gofmt, vet, staticcheck and the tests. I checked it by building the real site with it and with the Python generator and comparing the two page by page (17 of 17 identical), and with the Nu HTML Checker (no messages). A review of the whole branch found one regression (a quote in a title broke `og:title`) and three robustness issues (clashing output addresses, unsafe asset paths and language codes, the `Switch` key); all four are fixed with tests. The minor findings are in #2. Closes #1
squid merged commit 324f015737 into main 2026-11-15 09:04:38 +00:00
Sign in to join this conversation.
No reviewers
No labels
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
squid/motorino!3
No description provided.