# kmalloc.org Sources of the kmalloc.org website: plain static HTML, no JavaScript, valid HTML5 and CSS. ## Layout - `build.py` generates the site: `python3 build.py [output-dir]` (default `preview/`). Standard library only. - `templates/` holds the page chrome: `base.html`, `header.html`, `footer.html` and a few small fragments. - `static/style.css` is the one stylesheet, inlined into every page. - `content/site.toml` holds the values shared by every page: contact address, Bitcoin address, manifesto version. - `content//lang.toml` holds the chrome strings of one language (`en`, `it`). - `content//*.html` are the pages: a front matter block, then an HTML fragment. - `content//news/` holds the news posts. - `MANIFESTO.en.md` and `MANIFESTO.it.md` are the manifesto texts, version 1.0. - `fonts/terminess.woff2` is Terminess (Terminus), SIL Open Font License, subset to Latin. - `badges/` holds the official W3C badges, served from our own site. - `logo/` holds the shrike logo: SVG and PNG exports, `build_logo.py`, the original PNG and the favicons in `logo/web/`. ## Pages A page starts with a front matter block, then the HTML fragment: --- id: people path: /people.html nav: people title: kmalloc.org: People description: The people behind kmalloc.org. ---

People

`id` pairs a page with its translation, `nav` is the menu entry to highlight. Placeholders such as `{{contact_shown}}` or `{{url_news}}` are replaced at build time, and an unknown placeholder stops the build. ## News A post is a Markdown file named `YYYY-MM-DD-slug.md` in `content//news/`: --- title: Hello summary: One line shown in the list. --- Text with a [link](https://kmalloc.org/) and `code`. ## A heading The post is published at `/news/slug.html` (`/it/news/slug.html` for Italian). A post with the same file name in both languages is linked as a translation. The news index, the latest three posts on the home page and an RSS 2.0 feed (`/news/feed.xml`, `/it/news/feed.xml`, the latest 20 posts with full text) are built from the files. Every page links its feed in the head. No em dashes: the build refuses them. ## Publishing I check every page with the Nu HTML Checker, then copy the output to the web root on the server.