Sources of the kmalloc.org website
  • Python 39.1%
  • HTML 34.8%
  • CSS 26.1%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-11-15 10:23:31 +01:00
.forgejo/workflows ci: build the site with the pinned motorino and check it on every pull request 2026-11-15 10:23:31 +01:00
badges feat: add kmalloc.org website generator, manifesto and logo sources 2026-11-12 17:18:33 +01:00
content chore: remove the Python generator and the migration tools 2026-11-15 10:11:29 +01:00
lang feat: move the pages to Markdown and the news to the dated layout 2026-11-15 09:58:10 +01:00
logo feat: rust Dissent in the hero, shrike mark in the header and link preview metadata 2026-11-14 11:08:38 +01:00
news feat: move the pages to Markdown and the news to the dated layout 2026-11-15 09:58:10 +01:00
static feat: offer the logos as a downloadable pack and announce the shop 2026-11-14 20:05:44 +01:00
templates feat: move the pages to Markdown and the news to the dated layout 2026-11-15 09:58:10 +01:00
.gitignore feat: add kmalloc.org website generator, manifesto and logo sources 2026-11-12 17:18:33 +01:00
.motorino-version chore: pin motorino 1.0.0 with the SHA-256 of its binary 2026-11-15 10:06:30 +01:00
LICENSE chore: remove the Python generator and the migration tools 2026-11-15 10:11:29 +01:00
README.md chore: remove the Python generator and the migration tools 2026-11-15 10:11:29 +01:00
site.json feat: move the pages to Markdown and the news to the dated layout 2026-11-15 09:58:10 +01:00

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.md is the home of a folder. The file path is the address: content/it/servizi.md is /it/servizi.html.
  • news/ holds the news, written in English only: one name.md file each.
  • site.json holds 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>.json holds 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 in templates/pages/ (page, bare, manifesto), the news post (post.html) and the category page (category.html).
  • static/style.css is 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.png is the preview image of shared links), build_logo.py, the original PNG and the favicons in logo/web/.
  • .motorino-version pins the version of motorino (line 1) and the SHA-256 of its linux/amd64 binary (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.