Claude
be2c204d56
The design canvas (v17) gains the Documents artboard -- the Book of Fabric and the Dictionary of v4 first, then the book, the three volumes and the API reference, each with its SHA-256, and the SSRN paper -- and Downloads and Documents in every .com nav; Downloads' reading list becomes a pointer to Documents. site/com/canvas/ copied from it. site/com/build.py --release TAG --sums SHA256SUMS builds Downloads and Documents from the release ([TAG], [RELEASE]/<file>, [SHA:<file>]; a file the release's SHA256SUMS lacks fails the build). Without a release it builds Home, Try it and Inquiries exactly as before -- byte for byte -- with no link to the two pages, so they go live only with alpha.4. install.sh installs them when built. scripts/nightly.sh gitea-release: the release's SHA256SUMS now covers every file it attaches -- the images' sums, then the PDFs and the Root CA's certificate -- so `sha256sum -c SHA256SUMS` checks all of it and Documents finds each sum. The Nexus artifacts keep their own. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01GE3SDvQn5EoxdGufk84zz2
2.9 KiB
2.9 KiB
alpha.4's documents and pages -- progress (kept current, one line per increment)
Captain Bob, 2026-11-10: "Do it" -- the rest of alpha.4 that lives in the tree, after #92 (merged, #160). #133 and #134 are the server's (Captain Bob's).
#138 -- The Book of Fabric
docs/book/fabric.tex: the FABRIC record as one book -- Part I the living record (FABRIC-3), Part II the closed ones in order, Part III the forward-looking notes; title page with the version (git describe --tags) and the commit. The book's preamble moved intodocs/book/preamble.tex, shared by both books (the book itself builds unchanged, 821 pages).make fabric->build/docs/BookOfFabric.pdf(722 pages, 42 s).scripts/nightly.sh docsbuilds it ($DOCS/fabric.pdf);publishsends it asorg.starship:documentation:<version>, classifierfabric;gitea-releaseattaches every PDF in$DOCS, so the release carries it.
#157 -- the dictionary of v4, and the .com's Documents page
- the live word list of the built system (318 words):
v4/tools/mkdictionary.py words-- the hosted v4'sWORDS(317) plus the kernel'ssk_v4_words[](MINT-ZUSE) - the table in the tree,
docs/reference/v4-dictionary.tsv: all 318 entries, written in three alphabetical batches against v4's own definitions (the source gave 54 stacks and 105 descriptions to start from);checkpasses - the check:
mkdictionary.py check-- every live word has a finished entry, every entry a live word; run bymake dictionary, so a stale table fails the build and the nightly - the PDF, alphabetical:
make dictionary->build/docs/Dictionary.pdf(20 pages;docs/book/dictionary.tex); the nightly's docs stage builds it,publishsends classifierdictionary, the release attaches it - the Documents page: the canvas artboard (
project/Documents.dc.html, canvas v17: the Book of Fabric and the Dictionary first, then the book, the volumes, the API; each with its SHA-256; the SSRN paper), thensite/com/canvas/Documents.dc.html
#126 -- the Downloads page live
site/com/build.py --release TAG --sums SHA256SUMSbuilds Downloads and Documents:[TAG],[RELEASE]/<file>(the Gitea release's file),[SHA:<file>]; a file not in SHA256SUMS fails the build. Without a release it builds the three pages as before, byte for byte, with no link to the two.install.shinstalls them when they are built. The release's SHA256SUMS now covers every file it attaches (the images, the PDFs, the Root CA's certificate):nightly.sh gitea-release- the nav links on Home, Try it, Inquiries (canvas v17; shown only when the two pages are built)
At the alpha.4 release (after gitea-release): download the release's SHA256SUMS, then
python3 site/com/build.py --release v4.0.0-alpha.4 --sums SHA256SUMS and
XWIKI_USER=rajames XWIKI_PASSWORD=... site/com/install.sh (Captain Bob's; the .com's login).