Name
the site - tilder, documented by tilder
tilder has a site: this one. It holds the documentation, the reasons behind the tool, a showcase and these release notes, in English and in French. tilder builds it with the documentation theme of the site's own repository, so every page is also its own example.
Built by tilder
Each page is one Markdown file, rendered twice: an HTML page for browsers, and a text mirror, 75 columns wide, for terminals. A terminal client gets the mirror instead of the HTML:
curl tilder.thosted.frThe pages load nothing from another site, and read in full without JavaScript.
tilder 1.2.0
The site documents tilder 1.2.0 and is built with it. The image is ghcr.io/thosted/tilder:1.2.0.
Nested collections. A collection may read its folder at any depth, with recursive = true: content/docs/guide/install.md is an item of docs, served at /docs/guide/install. Each folder is a section, whose own page is its index.md or a guide.md beside the folder; the sidebar becomes a tree, and the order, the lists and the previous and next links walk it depth first. A dated collection, such as a blog, stays flat.
Theme checks. build.py --check checks the site's theme against the tilder that builds it, then exits without building: every class the builder writes needs a rule in style.css, unless the theme names it in [check] unstyled, and the colour pairs the theme declares in [check] contrast must meet their contrast minimum, in the light and the dark scheme. Both lists live in the theme's theme.toml. It prints one error: line per problem and a summary line per check, and exits 1 when a check fails.
A site that sets nothing new builds exactly as it did with 1.1.
What 1.1.0 brought
Collection navigation. A type marked SEQUENTIAL gives its items a place in an order: a theme draws the sidebar and the previous and next links with {{ collection_nav }}, {{ prev }} and {{ next }}, items may gather under a group, and the text mirror gets a line naming the previous and the next page. Per-language outputs. A type marked LOCALIZED_OUTPUTS writes its own files, such as a search index, once per language, under that language's prefix. Languages themselves came with 1.0.0.
Two smaller changes: a theme's theme.<lang>.toml for a language the site does not declare is ignored, and the Docker image carries the reference documentation in /tilder/docs/.