Writing

Files, frontmatter, and what the sidebar makes of them.

A page is a file. A directory is a section. That is the whole model, and it is why this manual needs no menu anywhere in its config.

Frontmatter

#let frontmatter = (
  title: "Writing",
  order: 2,
  summary: "Files, frontmatter, and what the sidebar makes of them.",
)

order decides where a page sits among its siblings. Pages without one tie, and ties fall back to the source path, which is already the order a directory reads in.

Headings

Second-level headings become the contents on the right, third-level ones nest under them. The entry lights up as you reach its section.

A third-level heading

Like this one, which exists to prove the indent.

And another

The list is built from the rendered page rather than from the template, because the headings live in the body and the layout never sees them.

Tables

Field Required What it does
title yes the page title, the sidebar entry, the search result
order no position among siblings
summary no the lead under the title, the search snippet

On this page