Rether / docs
meta/Colophon — how this site works
reference

Colophon — how this site works

updated 2026.05.18created 2025.04.02~1 min

What you're reading and how it's put together. Shares its visual language with the main portfolio at rether.fr ↗ but runs as its own thing on this subdomain.

The build

Every note is a .md file inside src/content/notes/. The folder path becomes the sidebar folder; the filename becomes the slug. Folders, the recent list, the tag index, search, and the backlink graph are all derived at build time by Astro — there's no database, no CMS, and no runtime server.

Inside a note, slug is a wiki link. At build time the body is compiled to HTML with the slug syntax preserved. On load the site scans every note for those references and inverts the map, so each page knows who points at it. The note-taking philosophy behind it is in How I take notes.

Type & colour

JetBrains Mono for body and code, Space Grotesk for display. A warm paper background, one terracotta accent, and a dark mode that's actually dark — the same system the portfolio uses, so the two feel like one studio.

SWAP

To add a note: create a .md file anywhere under src/content/notes/, run npm run build. Nothing else needs to change.

Keyboard

search this vaultK / /
step the sidebarjk
open selected
switch browse mode123
switch vaultgv
toggle themet
close / clearesc
this help?
esc to close