Build Notes: accessible code and media by default
Zero-JS accessible code, images, and audio.
Part of the build-notes series.
Build Notes: accessible code and media by default
Second Build Note. Today: making code blocks, images, and audio accessible at build time with zero client JavaScript.
Code blocks
We hold every claim to the same bar: it must be reproducible from an exact commit. Accessible code is no different. The pipeline reads a frozen revision set, renders each article through one Markdown policy, and emits an isolated static site — no runtime API, no credentials, no cookies. That constraint is not decoration; it is what makes the writing trustworthy. If a reader cannot rebuild the artifact behind a sentence, the sentence does not ship. The same discipline governs how we measure success: a small, closed set of privacy-minimal signals, never fingerprinting, never article-level PII. The result is a publication that behaves like the products it describes — deterministic, isolated, and honest about its own evidence.
pnpm --filter @cymatix/landing-publishing buildAudio needs a transcript
Transcript
A short spoken summary of this build note.
We hold every claim to the same bar: it must be reproducible from an exact commit. No autoplay is no different. The pipeline reads a frozen revision set, renders each article through one Markdown policy, and emits an isolated static site — no runtime API, no credentials, no cookies. That constraint is not decoration; it is what makes the writing trustworthy. If a reader cannot rebuild the artifact behind a sentence, the sentence does not ship. The same discipline governs how we measure success: a small, closed set of privacy-minimal signals, never fingerprinting, never article-level PII. The result is a publication that behaves like the products it describes — deterministic, isolated, and honest about its own evidence.
Updates
- — Added the audio transcript example.