- Python 39.1%
- HTML 34.8%
- CSS 26.1%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
| .forgejo/workflows | ||
| badges | ||
| content | ||
| lang | ||
| logo | ||
| news | ||
| static | ||
| templates | ||
| .gitignore | ||
| .motorino-version | ||
| LICENSE | ||
| README.md | ||
| site.json | ||
kmalloc.org
Sources of the kmalloc.org website: plain static HTML, no JavaScript, valid HTML5 and CSS. The site is built with motorino, the generator I wrote for it.
Layout
content/<lang>/holds the pages as Markdown, one file per page and language (en,it,es,de,fr).index.mdis the home of a folder. The file path is the address:content/it/servizi.mdis/it/servizi.html.news/holds the news, written in English only: onename.mdfile each.site.jsonholds what every language shares: the language list, the contact and security addresses, the Bitcoin and shop addresses, the manifesto version and date, and the assets that are copied as they are.lang/<lang>.jsonholds the interface strings of one language: the menu, the footer and the other short texts.templates/holds the chrome (base.html,header.html,footer.html), the layouts intemplates/pages/(page,bare,manifesto), the news post (post.html) and the category page (category.html).static/style.cssis the one stylesheet, inlined into every page.badges/holds the official W3C badges, served from our own site.logo/holds the shrike logo: SVG and PNG exports (og-1200x630.pngis the preview image of shared links),build_logo.py, the original PNG and the favicons inlogo/web/..motorino-versionpins the version of motorino (line 1) and the SHA-256 of itslinux/amd64binary (line 2).
Writing a page
Every page starts with a header of Key: value lines ended by a line with a single -, then Markdown. Raw HTML is allowed, for the few things Markdown cannot say (the data table, the hero of the home page).
Title: Services
ID: services
Description: The services on kmalloc.org and how to get an account.
Layout: bare
-
# Services
Write to **{{contact_shown}}**.
## Get an account {#account}
ID is the same in every language: it links the translations. Layout is page (the title as a heading, then the body), bare (the body only, which writes its own # heading) or manifesto. A heading can set its id with {#id}; the others get one from their words. {{name}} is replaced by a string of site.json or of the language file, and an unknown one stops the build. {{news_list}}, {{latest_news}} and {{categories_list}} stand alone in a paragraph and expand to lists. The full list of keys is in the motorino README.
A new language is one file lang/<lang>.json, its name in site.json and its pages in content/<lang>/. A language lists only the pages it has: Spanish, German and French have the manifesto only, so they use the short header ("header": "header-min"). A translation of an older manifesto says which version it translates with ManifestoVersion and ManifestoDate.
News
A news item is a file news/name.md:
Title: Hello from kmalloc.org
Author: squid
Date: 2026-09-18T17:00:45+0200
Categories: News
Description: One line shown in the list.
-
The text, with a [link](https://kmalloc.org/) and `code`.
It is published at /news/YYYY/MM/name.html, with the year and month of Date. Every category has a page at /news/category/<name>.html. The news index, the latest three news on the home pages and an RSS 2.0 feed (/news/feed.xml, the latest 20 news with full text) are built from the files. No em dashes: the build refuses them. The first three news also answer at their old addresses (/news/status-page.html and so on) through permanent redirects in the Caddyfile of shrike-infra.
Preview
motorino build -site . -out preview
cd preview && python3 -m http.server 8197 --bind 127.0.0.1
Get the binary of the pinned version from the releases of motorino, or build it from its repository with make build. I check the output with the Nu HTML Checker before I push.
Indexing
Every page, news item and category page may be indexed. robots.txt allows exactly their addresses and blocks the rest (the downloads and the assets). The personal pages under /~name/ are not built here and carry noindex.
License
The texts are released under CC BY-SA 4.0, see LICENSE. The code and the logo are not covered; the logo pack has its own terms in its README.
Publishing
Pushing to main publishes the site. A post-receive hook in the Forgejo repository touches a trigger file, deploy-kmalloc-site.path on the server notices it and runs deploy-kmalloc-site. The script builds main into a temporary directory with the pinned motorino and mirrors it into the web root. It downloads the binary once, checks it against the hash in .motorino-version and keeps it in /var/cache/kmalloc-deploy. If the hash or the build is wrong nothing is copied.
To move to a new motorino: take the version and the SHA-256 from its release and write them in .motorino-version.