Frontmatter

Every content file begins with a YAML frontmatter block delimited by ---. The required and optional fields differ by content type.

Blog posts (content/blog/)

FieldRequiredDescription
titleyesPost title
slugyesURL segment — must be unique across all content
authoryesAuthor name
createdyesPublication date (YYYY-MM-DD)
updatednoLast-edited date
imagenoPath or URL to a hero image, rendered above the post body and shown in blog listings
descriptionnoShort summary shown in blog listings (home page, blog index)
tagsnoList of tag strings
---
title: Hello World
slug: hello-world
author: Alice
created: 2026-01-01
tags:
  - rust
  - tutorial
---

Blog posts live at /blog/<slug>/.

Wiki pages (content/wiki/)

All fields are optional. The page title falls back to the filename stem if title is omitted.

FieldRequiredDescription
titlenoPage title
categorynoCategory name — pages are grouped by category on the wiki index
creatednoCreation date
updatednoLast-edited date
tagsnoList of tag strings
---
title: Glossary
category: Reference
tags:
  - reference
---

When category is set, the wiki index groups pages under category headings. Pages without a category appear in an "Uncategorized" section at the end.

Wiki pages live at /wiki/<stem>/ regardless of category — the category is purely for display grouping.

Standalone pages (content/pages/)

FieldRequiredDescription
titleyesPage title, shown in nav
ordernoSort position in the nav (lower = earlier)
---
title: About
order: 1
---

Standalone pages live at /<stem>/.

See also: Configuration, Wiki Links.