writing posts
where a post goes, its frontmatter, and what the build checks
where it goes
a post is content/blog/<category>/<slug>.mdx and lands at /<category>/<slug>, the folder is the category,
there is no category field. one level of folder only, a deeper file fails the build rather than going live at a url
nothing links to
a category gets a nicer label and a blurb by adding it to categories in lib/blog.ts, an unlisted folder still
works and just shows its slug with the dashes taken out
some names are taken by routes and fail the build as a category, docs api og page series tags
rss.xml sitemap.xml and the llms files, and a post cant be called page
frontmatter
---
title: the title # required
description: one line blurb # shows on the card, the og image and the feed
date: 2026-10-06 # required, a bad date fails the build
updated: 2026-10-08 # optional, shows under the meta line and in the sitemap
author: Finn Le Var # optional, this is the default
tags: [lua, c api] # optional, any spelling, the url is the slugified form
image: /img/cover.png # optional, replaces the generated og card
draft: true # optional, only shows under npm run dev
series: lua-bindings # optional, needs part too
part: 2 # the posts place in the series
---drafts
draft: true shows the post under npm run dev with a draft badge, a production build leaves it out of every
list, route, tag, series, search index, og image, sitemap and the rss feed, so pushing a draft is safe
series
every post with the same series slug is one series, ordered by part rather than date. each part shows a box
listing the others, and /series/<slug> lists them all. a label and blurb go in series_labels in lib/blog.ts
the rest
- tags each get a page at
/tags/<tag>, and/tagslists them all - the front page and each category page 10 posts at a time,
page_sizeinlib/blog.ts - the feed is
/rss.xml, the newest 20 posts - relative links between
.mdxfiles work,[the other post](../notes/other.mdx)