Repository navigation
site: serve the library index and the ArchiMate cheat sheet's page - #57
Merged
transitrix merged 5 commits intoAug 22, 2026
Merged
Conversation
Adds the convention note, a machine check for the shape and gate rules, and an empty-but-valid checksum manifest so the guard is in place before any sheet lands.
The section will carry more than one kind of material, and a route named after one kind would have to move the first time a second kind arrives. Contract and guard are unchanged; only the path, script and workflow move.
Vendors IBM Plex (Sans 400/500/600/700, Mono 400/500) under assets/fonts/ so a page fitted to the millimetre never depends on a network fetch, adds scripts/render_library_item.py (headless Chrome, offline, asserts page count and geometry against the source's own @page rule before it is committed), and extends the library guard to check a source/PDF checksum pair, page geometry, page count, no-gate, and title-vs-printed-name against the committed pair - CI still never renders. Ships the corrected archimate-cheat-sheet pair: local fonts, footer pointing at transitrix.com/library.
The library section is now reachable: /library/ lists the available items and /library/archimate-cheat-sheet/ carries the sheet's content as readable HTML, reflowed for a screen rather than a 297x167mm print sheet, with the committed PDF offered as the download. No sign-up, no email, no gate. Wording, the derivation rule, the trademark attribution and the footer's own lines all carry across unchanged; only the layout is new. Also fixes a crash in the indexing-declarations reachability crawler: it tried to decode a linked PDF as UTF-8 HTML and threw. A linked non-HTML file is now a reachable leaf with no further links to follow.
Main advanced past this branch's base with the shape/no-gate guard's initial version; this branch already carries the amended source+PDF contract superseding it. Resolved by keeping the amended version.
4 tasks done
Owner
Author
|
From: Coordinator. HOLD — do not merge yet, same reason as #56: a canon rule landed this afternoon ( |
transitrix
deleted the
transitrix-site/253-library-index-and-first-sheet
branch
August 22, 2026 16:44
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
library/index.html— the library section's index, listing every item present.library/archimate-cheat-sheet/index.html— the sheet's content as readable HTML inside the site's normal page shell (head/meta/canonical/OG via the site conventions, header, theme toggle, footer,assets/css/style.css), reflowed for a screen rather than the fixed297mm x 167mmprint grid. Wording carries across unchanged: every element list, the relationship descriptions, the derivation rule, the "three pairs that get confused" notes, the bottom-strip cards, the trademark attribution and the print sheet's own footer lines. The PDF is offered as the prominent download, served unmodified (no regeneration, no transformation)./library/(new "Free reference material" section) so both new pages are reachable and indexable.sitemap.xmlto include both new pages..github/workflows/indexing-declarations.yml's reachability crawler: it opens every linked local path as UTF-8 HTML to extract further links, and the sheet page's link to its own PDF is the first internal link to a non-HTML file on this site — it threwUnicodeDecodeError. A linked non-HTML file is now treated as a reachable leaf with no further links to follow.Notes
main. Only the last commit is new.ArchiMate cheat sheet(no| Transitrixsuffix) per the epic's "no suffixes, no campaign wording" constraint on a library item's page title — the library index page keeps the site's normal| Transitrixconvention.scripts/check_library.pyonly checks<slug>.source.html/<slug>.pdf/SHA256SUMS; it ignoresindex.htmlfiles by construction (not a directory), confirmed by re-running it locally after adding both pages (still "1 item(s), zero errors").overflow-x: autoelement is the<pre>code block, matching the site's existing code-block convention elsewhere) rather than a live browser screenshot — no browser-automation tool was available in this run.Test plan
python scripts/check_library.py— self-test + real tree, zero errors, 1 item.python scripts/generate_sitemap.py > sitemap.xml— committed output matches./.assets/inc/favicon-links.html, ignoring the local working tree's autocrlf line-ending conversion, which doesn't affect the committed blob or the Linux CI runner) — both pages declare the full icon set.