Sample post
This post exists to be edited. It marks the spot where my own writing goes, and its front matter above documents every key the templates read.
Where a post shows up🔗
- The
/blog/list: row with date, thumbnail (when there is apreview), title and description. - The home page: the newest three posts become cards under “Latest writing” – the block hides itself while the section is empty.
- Tag pages: each tag and folder gets an archive page under
/tags/, and the tag landing lists every term site-wide. - The blog post itself: sidebar with the sibling posts, meta line, chips, hero image and a right-hand table of contents built from the headings.
Topic tags vs folders🔗
Both are just tags in taxonomies.tags. A folder adds one line – folders = [...] in [extra] – and turns into a named filter in the sidebar instead of a #slug chip. Everything else (URLs, search, the tag pages) keeps using the plain slug. The display copy lives once per folder in [extra.tag_meta] of content/blog/_index.md.
Front matter quick reference🔗
| Key | Required? | Where it shows |
|---|---|---|
title | yes | H1, list row, card, browser tab, search results |
description | strongly advised | header lede, row/card excerpt, <meta>, search |
date | yes (section sorts by it) | row meta line, post meta line, sidebar |
updated | optional | post meta line only when different from date |
draft | optional | hides the page until you flip it off |
taxonomies.tags | optional | chips, tag pages, sidebar filter |
[extra] folders | optional | marks tags as named collections (folders) |
[extra] preview | optional | 16:9 crop in lists, cards and the article hero |
Project-only keys (org, role, period, weight, the featured tag) are documented in the sample project; gallery keys (image, camera, location) in the sample frame.
Delete me – one scaffold per section is plenty.