Repository navigation
Finish reproducible brand manual and release process #3
Description
Activity
Toolchain decision recorded in
docs/decisions/0001-manual-toolchain.md: Typst is the accepted initial publishing stack. A minimalmanual/main.typand GitHub Actions build workflow are now in place; the remaining work is migrating and validating the complete historical manual content/assets.Historical manual audit completed. The 7-page manual covers primary logo/icon, institutional palette, color variants, clear-space construction, minimum dimensions, and Catamaran typography.
The current website has evolved away from parts of this manual (Montserrat and #184c4e as primary digital token). Issue #7 now tracks the required reconciliation before the new Typst manual declares a final contemporary palette/type hierarchy.
- changed the title
[-]Create reproducible open-source brand manual[/-][+]Finish reproducible brand manual and release process[/+]on Sep 24, 2026 Editorial redesign implemented. Both brand manuals now share the same content architecture and editorial engine (
manual/components.typ), whilemanual/theme.typcontains brand-specific color, typography, and motif tokens. Official open-source fonts are vendored from Google Fonts under OFL-1.1 and used via--font-path source/fonts. The manuals now include full-page section openers, branded covers/back covers, logo construction/composition, primary/reversed applications, color swatches, typography specimens, clear-space guidance, minimum-size guidance, accessibility, and governance. The shared structure is documented indocs/manual-content-contract.md; open Typst reference implementations are documented in ADR 0002. Builds, Brand quality, and REUSE are passing. The remaining work in this issue is final visual QA of the latest PDFs and any last art-direction refinements before the first versioned release.Visual QA pass completed against the original manual and the rendered PDF. Fixed logo framing/cropping, typography specimen line breaks, explicit clear-space construction, duplicate application markup, and clickable back-cover URL. Clear-space rules are now normative in
guidelines/visual-identity.mdas well as illustrated in the PDF. PDF/UA manual build, Brand quality, and latest publication all passed for the refined manual source.Asset/manual pipeline overhaul completed. The repository now has one editable canonical
*-master.svg, one machine-readablesource/artwork/brand-assets.json, and a singlescripts/build_assets.pyused by local builds, asset CI, manual CI, the continuouslatestrelease, and versioned releases. Inkscape--export-area-drawingcomputes the real drawing bounds; safe framing, primary/reversed/monochrome variants, PNG/PDF/SVG exports, and clean-space reference glyph crops are deterministic outputs. The manual consumes only generated assets frombuild/assets/, never hand-edited derivatives. LibreCode clean space is now bound to the width of the actual D glyph from the wordmark; LibreSign uses the actual E glyph from the wordmark as the non-interference module. Visual QA confirmed the LibreCode page-7 clipping is gone and both clean-space pages use the measured canonical geometry. Current Build brand manual, Brand quality, REUSE, and Publish latest brand build workflows are green.Clear-space construction was refined again using the original designer manuals as the visual reference. LibreSign now uses the actual E extracted from the wordmark as the guide glyph, recolored automatically by the asset generator; top/bottom E remain upright, side E are rotated, and all four are centered on the dashed exclusion boundary. LibreCode now shows the actual D reference explicitly as the source of X, then applies X around the mark between the inner artwork frame and outer protection frame. Both pages are generated from the canonical master via
scripts/build_assets.py; no manual derivative editing is involved. Latest PDF build, Brand quality, REUSE, and latest publication are green, and page 13 was visually inspected after rendering.
Metadata
Metadata
Assignees
Labels
Type
Fields
Priority
The LibreSign manual is authored in Typst and built reproducibly in CI.
Completed
manual/main.typis canonical sourcev*tagsRemaining
v1.0.0release PR from the approvedmainv1.0.0Distribution contract
brand-manual.pdfas a temporary Actions artifact.latestprerelease publishes the current development build frommain.v*releases publish permanent versioned PDF and artwork assets in GitHub Releases.The repository metadata is complete. The current manual is usable through the mutable
latestdevelopment release, but stablev1.0.0is intentionally deferred until external homologation/review is complete. PR #22 was closed without merge. After approval, prepare a fresh release PR from the currentmain; the existing release workflow will build, validate, checksum, and publish the versioned artifacts.