From 5874742494a293c5e285d2f1284c748e39d980f8 Mon Sep 17 00:00:00 2001 From: Gabriel Schneider Date: Thu, 1 Oct 2026 11:11:25 -0300 Subject: The docs become a website: a page per chapter, a landing page with recordings, one Typst bundle run MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit docs/site/site.typ writes every page in one bundle compile: the landing page (the tagline, the recordings listed in media/clips.toml, links to start from), a page per entry of `chapters` in style.typ, and the tutor. Every page shares a tag-line header with the chapter words; #doc links resolve to the right page and anchor; a chapter with four or more sections gets an "On this page" list. Links are relative and pages flat, so it reads from file:// or any static server. `zig build site` installs it to /share/doc/pardes/site and fails plainly without typst. The look is 0x4200.cafe's lapis layout (framed panels, hard shadows, a tag-line trail, Departure Mono headings over Crimson Pro) in orchard's greens and amber, forestbones_light when the reader prefers light; both fonts are OFL and shipped. In HTML a key is one pill with its + and ›, and a mouse button is an inline SVG in currentColor. The tagline lives once in style.typ for the sheet, the book and the site, and the single page html.typ gives way to the site. The landing leads with one plain sentence (columns of panes, click to run or open, helix keys, scripts through files), then the tagline and a line on where it runs; a hero image is the first ready clip's poster; "Start: the guide" leads the links, "Hands on: the tutor" next, the rest a plain row; the captions use no undefined words. docs/typ/install.typ holds the install lines once: setup.typ has an Install section that includes it, and the landing includes it too. Building says up front it is for contributors and points at setup to install. In HTML the guide's glossary is a closed
(#glossary, the same heading and table on paper), each drawn mouse carries hidden text (left-click, hold left, click middle) for screen readers, w3m and copying, and the footer takes a source link and a licence from `project` in style.typ once decided. Co-Authored-By: Claude Opus 5.5 --- docs/typ/book.typ | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) (limited to 'docs/typ/book.typ') diff --git a/docs/typ/book.typ b/docs/typ/book.typ index a89b52cc..7223ea1d 100644 --- a/docs/typ/book.typ +++ b/docs/typ/book.typ @@ -2,7 +2,7 @@ // content files named by `chapters` in style.typ; this is layout only. // typst compile --root . --ignore-system-fonts docs/typ/book.typ // (--root . because the tutor is read from src/tutor.txt.) -#import "style.typ": palette, mono, chapters, tutor-path, doc-links +#import "style.typ": palette, mono, chapters, tutor-path, doc-links, tagline #set document(title: "pardes") #doc-links.update(true) @@ -29,7 +29,7 @@ v(1fr) text(size: 34pt, weight: "bold", fill: palette.tag-name)[pardes] v(4mm) - text(size: 13pt, style: "italic", fill: palette.tag-fg)[acme's tags and three buttons, helix's keys, terminals as panes, the editor as a 9P filesystem] + text(size: 13pt, style: "italic", fill: palette.tag-fg, tagline) v(2fr) }) -- cgit v1.3