istosandClaude Opus 5
62caafe157
bench has no public page. site/ is the machinery for one: a manifest, a generator, two layouts from the turn-2 docs design, and the Daylight half of the board's own token set. Nothing here is transcribed. Every page body is a heading slice of a file that already documents bench, and site/pages.json is the only place that mapping is written down — the IA is editorial judgement, so it lives in one readable file rather than in a directory convention. The point is the failure: a from/to heading the source no longer contains stops the build naming the route, the file and the heading, and every page renders before the output directory is touched, so a drifting rebuild leaves the last good build standing instead of replacing it with an empty one. Repo-relative links come out as site routes or GitHub links; a dead one stops the build too. Rendering is markdown-it-py, pinned in site/requirements.txt. The stdlib-only law binds manager/core/ — the tool people install — and site/ is neither shipped nor installed, so a hand-rolled parser would have been risk spent in the wrong place on a document that leans on fenced code, nested lists and inline code throughout. Templates are string.Template: $name substitutes and a literal dollar doubles, because str.format's braces collide with every line of CSS. Fonts are self-hosted and same-origin: no page bench serves may need a request to a third party to be read. fetch-fonts.py downloads the seven woff2 files once; until they are there the build says which are missing and the pages fall back to the system stack. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
12 lines
458 B
Plaintext
12 lines
458 B
Plaintext
# The minisite's only dependency, pinned.
|
|
#
|
|
# The stdlib-only law binds manager/core/ — the tool people install. This
|
|
# directory is neither shipped nor installed (manager/core/release-manifest:
|
|
# "Anything not listed here does not ship"), and AGENTS.md leans on fenced
|
|
# code, nested lists, inline code and tables, which is a bad place to spend
|
|
# risk on a hand-rolled parser.
|
|
#
|
|
# python3 -m pip install -r site/requirements.txt
|
|
#
|
|
markdown-it-py==4.0.0
|