site: plate images are the links; type in the top bar

Merged
RI
3d ago
+798-326

The generator for the three sites (machine-made, openfluids, BoringQuantSystems). The openfluids and BoringQuantSystems repositories get the same build in docs/, one PR each.

What changed

  1. The plate image is the link. The banner of each repository links to the repository. The repository name under it is gone (the banner shows it). The one-line description stays. Where a project has its own site or docs, a small link follows the description: docs for linstabpy, site for dynachaos, chaos-atlas and type. The image link is named with aria-label="<repo>" and the image has alt=""; the checker enforces both, and fails when the name text comes back or the line starts with the repository name.
  2. type in the top bar on all three sites: machine-made · openfluids · BoringQuantSystems · type, linking to https://machine-made.github.io/type/. The current site is marked with aria-current="page" and is not a link. llms.txt lists the type site with the other three.
  3. Only machine-made fonts, version 0.2.0. Weft is the variable MachineMadeWeft[FRAG,wght].woff2. openfluids text moves from Lato to machine-made Sans (variable, roman only: the page uses no italic). BoringQuantSystems text moves from EB Garamond to machine-made Warp (Regular and Italic; no bold is used). The files are byte-identical to the 0.2.0 release assets and to what the type site serves; the README font table records version, source asset, size and SHA-256 of each. The old font files, their licences and fonts.py (which cut a 0.1 subset) are removed; the README line that named the removed licence file in the BoringQuantSystems repository is fixed. check_site.py fails on a font family or a font file that is not machine-made, on a machine-made file whose SHA-256 is not the 0.2.0 one, on a stack that names a system font (generic fallbacks only), and on bold or italic that no loaded face provides. brand.py keeps drawing from the 0.1 cut, now kept in brand-fonts/, so brand/ is unchanged.
  4. Polish pass, item by item:
    • Type: one scale for the three sites (16 px base, 24 px house line, line height 1.55), now constants in the generator and checked (--fs, --ls, body line height). No bold and no italic is set anywhere; font-display: swap and the preload of the main text font are checked. Sans has a narrow word space, so reading text gets word-spacing: 0.05em on openfluids (--ws, checked).
    • Plates: the whole image is the click target. Hover draws an accent outline without motion (and the scale only under prefers-reduced-motion: no-preference); keyboard focus draws the accent outline (:focus-visible). The docs and site links are always underlined, so a touch screen shows them. Image heights and gaps are checked as equal. Every img has width and height.
    • Top bar and footer: the same order and spacing on the three sites; the current site is marked and not linked.
    • At 390 px: no horizontal scroll, 16 px side margins, every link at least 44 px high (the docs and site links are a plain 44 px row below the description there).
    • Head: the title is the site name; the description meta is the org line; rel="icon" is mark.svg; og:image is the absolute URL of the org banner, with og:title, og:description, og:url, og:type, image size and alt, and twitter:card.

Checks added: check_site.py (fonts, type scale, touch targets, hover state, plate markup, top bar, head and social preview; 262 self-test cases, 54 more than before) and shots.py (computed family, weight and style of every text element, equal plate heights and gaps, one marked top-bar entry, 16 px margins and 44 px links at 390 px, every face the text uses loaded).

Proof

sh gate.sh:

DETERMINISTIC
BRAND SKIPPED: set MM_FONTS=brand-fonts to check brand/
SELF-TEST OK (262 cases)
OK
OK
OK
HOUSES OK
grep clean

python3 check_site.py --site on the openfluids and BoringQuantSystems builds: OK, OK. The self-test also passes with each of those houses as the root site (257 and 258 cases), which covers the italic cases of the Warp house. MM_FONTS=brand-fonts sh gate.sh needs a Playwright browser that this machine does not have; it was not run (brand/ and brand-fonts/ are not changed).

shots.py (Chrome, at 320, 360, 390, 720, 1000, 1280 and 1920 px) on all three builds: no horizontal scroll, fonts loaded, no text outside machine-made fonts at weight 400 and normal style, plate geometry equal, no request outside docs/. A run on a copy with a bold group label and short links fails as it should.

Screenshots checked (opened, 1280 px and 390 px of each site): mm-1280.png, mm-390.png, of-1280.png, of-390.png, bqs-1280.png, bqs-390.png.

The openfluids and BoringQuantSystems docs/ are the output of this generator: a file-by-file hash comparison against each branch finds 0 files to change and 0 to delete.