diff --git a/.github/workflows/latest.yml b/.github/workflows/latest.yml index c177b99..6da26ab 100644 --- a/.github/workflows/latest.yml +++ b/.github/workflows/latest.yml @@ -39,17 +39,22 @@ jobs: run: | python scripts/build_assets.py --output build/assets typst compile --root . --font-path source/fonts --pdf-standard ua-1 manual/main.typ build/libresign-brand-manual.pdf + typst compile --root . --font-path source/fonts --pdf-standard ua-1 --input format=slides manual/main.typ build/libresign-brand-manual-slides.pdf cp build/assets/libresign-logo.svg build/libresign-logo.svg cp build/assets/libresign-logo.pdf build/libresign-logo.pdf cp build/assets/libresign-logo.png build/libresign-logo.png cp build/assets/libresign-logo-reversed.svg build/libresign-logo-reversed.svg - sha256sum build/libresign-brand-manual.pdf build/libresign-logo* > build/SHA256SUMS + sha256sum build/libresign-brand-manual.pdf build/libresign-brand-manual-slides.pdf build/libresign-logo* > build/SHA256SUMS - name: Validate PDF/UA-1 with veraPDF run: | docker run --rm \ -v "$PWD/build:/data:ro" \ verapdf/cli:latest \ --flavour ua1 --format text /data/libresign-brand-manual.pdf + docker run --rm \ + -v "$PWD/build:/data:ro" \ + verapdf/cli:latest \ + --flavour ua1 --format text /data/libresign-brand-manual-slides.pdf - name: Move latest tag to this build run: | git tag -f latest "$GITHUB_SHA" @@ -62,4 +67,4 @@ jobs: gh release create latest --prerelease --title "Latest development build" --notes "Continuously updated development build from the main branch. This is not a versioned release." fi gh release edit latest --title "Latest development build" --notes "Continuously updated development build from the main branch. This is not a versioned release." --prerelease - gh release upload latest build/libresign-brand-manual.pdf build/libresign-logo.svg build/libresign-logo.pdf build/libresign-logo.png build/libresign-logo-reversed.svg build/SHA256SUMS --clobber + gh release upload latest build/libresign-brand-manual.pdf build/libresign-brand-manual-slides.pdf build/libresign-logo.svg build/libresign-logo.pdf build/libresign-logo.png build/libresign-logo-reversed.svg build/SHA256SUMS --clobber diff --git a/.github/workflows/manual.yml b/.github/workflows/manual.yml index 7d3b1c2..643f12f 100644 --- a/.github/workflows/manual.yml +++ b/.github/workflows/manual.yml @@ -49,13 +49,20 @@ jobs: - name: Build accessible PDF run: | typst compile --root . --font-path source/fonts --pdf-standard ua-1 manual/main.typ build/brand-manual.pdf + typst compile --root . --font-path source/fonts --pdf-standard ua-1 --input format=slides manual/main.typ build/brand-manual-slides.pdf - name: Validate PDF/UA-1 with veraPDF run: | docker run --rm \ -v "$PWD/build:/data:ro" \ verapdf/cli:latest \ --flavour ua1 --format text /data/brand-manual.pdf + docker run --rm \ + -v "$PWD/build:/data:ro" \ + verapdf/cli:latest \ + --flavour ua1 --format text /data/brand-manual-slides.pdf - uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1 with: name: brand-manual - path: build/brand-manual.pdf + path: | + build/brand-manual.pdf + build/brand-manual-slides.pdf diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml index d411bda..2e45f4a 100644 --- a/.github/workflows/release.yml +++ b/.github/workflows/release.yml @@ -27,17 +27,22 @@ jobs: run: | python scripts/build_assets.py --output build/assets typst compile --root . --font-path source/fonts --pdf-standard ua-1 manual/main.typ build/libresign-brand-manual.pdf + typst compile --root . --font-path source/fonts --pdf-standard ua-1 --input format=slides manual/main.typ build/libresign-brand-manual-slides.pdf cp build/assets/libresign-logo.svg build/libresign-logo.svg cp build/assets/libresign-logo.pdf build/libresign-logo.pdf cp build/assets/libresign-logo.png build/libresign-logo.png cp build/assets/libresign-logo-reversed.svg build/libresign-logo-reversed.svg - sha256sum build/libresign-brand-manual.pdf build/libresign-logo.svg build/libresign-logo.pdf build/libresign-logo.png build/libresign-logo-reversed.svg > build/SHA256SUMS + sha256sum build/libresign-brand-manual.pdf build/libresign-brand-manual-slides.pdf build/libresign-logo.svg build/libresign-logo.pdf build/libresign-logo.png build/libresign-logo-reversed.svg > build/SHA256SUMS - name: Validate PDF/UA-1 with veraPDF run: | docker run --rm \ -v "$PWD/build:/data:ro" \ verapdf/cli:latest \ --flavour ua1 --format text /data/libresign-brand-manual.pdf + docker run --rm \ + -v "$PWD/build:/data:ro" \ + verapdf/cli:latest \ + --flavour ua1 --format text /data/libresign-brand-manual-slides.pdf - name: Publish versioned release env: GH_TOKEN: ${{ github.token }} @@ -45,4 +50,4 @@ jobs: if ! gh release view "$GITHUB_REF_NAME" >/dev/null 2>&1; then gh release create "$GITHUB_REF_NAME" --generate-notes --title "libresign brand $GITHUB_REF_NAME" fi - gh release upload "$GITHUB_REF_NAME" build/libresign-brand-manual.pdf build/libresign-logo.svg build/libresign-logo.pdf build/libresign-logo.png build/libresign-logo-reversed.svg build/SHA256SUMS --clobber + gh release upload "$GITHUB_REF_NAME" build/libresign-brand-manual.pdf build/libresign-brand-manual-slides.pdf build/libresign-logo.svg build/libresign-logo.pdf build/libresign-logo.png build/libresign-logo-reversed.svg build/SHA256SUMS --clobber diff --git a/manual/README.md b/manual/README.md index 9e35093..b29a48d 100644 --- a/manual/README.md +++ b/manual/README.md @@ -27,6 +27,14 @@ typst compile \ --pdf-standard ua-1 \ manual/main.typ \ build/brand-manual.pdf + +typst compile \ + --root . \ + --font-path source/fonts \ + --pdf-standard ua-1 \ + --input format=slides \ + manual/main.typ \ + build/brand-manual-slides.pdf ``` The same asset generator is used by local builds, CI, the continuous `latest` release, and versioned releases. @@ -61,3 +69,5 @@ For editor diagnostics, Tinymist is the recommended language server. Enable its - avoid brand-specific dead code and unused exports in shared component files; - keep source-derived technical diagrams outside Typst when geometry must remain authoritative; Typst should compose and scale those generated vectors; - do not add a Typst package dependency when a small local function is sufficient. + +The 16:9 PDF uses the same Typst source and brand rules. It is a widescreen reading format, not an abridged speaker deck; individual topics can flow onto more than one slide. Review both PDFs at their intended display size before publishing. diff --git a/manual/components.typ b/manual/components.typ index 46669ed..1d9b79c 100644 --- a/manual/components.typ +++ b/manual/components.typ @@ -2,6 +2,8 @@ // SPDX-FileCopyrightText: 2026 LibreSign contributors // SPDX-License-Identifier: CC-BY-SA-4.0 +#let slides = sys.inputs.at("format", default: "a4") == "slides" + #let motif(theme) = { if theme.motif == "nodes" { place(top + left, dx: -8mm, dy: -10mm, circle(radius: 18mm, fill: theme.accent)) @@ -117,7 +119,11 @@ ] #let manual-page(theme, kicker, title, body) = page( - margin: (left: 24mm, right: 22mm, top: 22mm, bottom: 20mm), + margin: if slides { + (left: 18mm, right: 18mm, top: 14mm, bottom: 12mm) + } else { + (left: 24mm, right: 22mm, top: 22mm, bottom: 20mm) + }, fill: theme.paper, footer: context { align(right, text( @@ -128,11 +134,16 @@ )) }, )[ - #place(left + top, dx: -24mm, dy: -22mm, rect(width: 4mm, height: 100% + 42mm, fill: theme.accent)) + #place( + left + top, + dx: if slides { -18mm } else { -24mm }, + dy: if slides { -14mm } else { -22mm }, + rect(width: 4mm, height: 100% + if slides { 26mm } else { 42mm }, fill: theme.accent), + ) #text(font: theme.heading-font, size: 8.5pt, weight: "medium", fill: theme.accent)[#upper(kicker)] #v(4mm) #heading(level: 2, outlined: true, bookmarked: true, numbering: none)[ - #text(font: theme.heading-font, size: 24pt, weight: "bold", fill: theme.ink)[#title] + #text(font: theme.heading-font, size: if slides { 26pt } else { 24pt }, weight: "bold", fill: theme.ink)[#title] ] #v(6mm) #body @@ -140,13 +151,19 @@ #let logo-stage(theme, logo, alt, dark: false) = block( width: 100%, - height: 78mm, + height: if slides { 56mm } else { 78mm }, fill: if dark { theme.ink } else { white }, radius: 4pt, - inset: 14mm, + inset: if slides { 9mm } else { 14mm }, )[ #align(center + horizon)[ - #image(logo, width: 72%, height: 55mm, fit: "contain", alt: alt) + #image( + logo, + width: 72%, + height: if slides { 38mm } else { 55mm }, + fit: "contain", + alt: alt, + ) ] ] @@ -154,7 +171,7 @@ columns: (30mm, 1fr), gutter: 8mm, align: horizon, - rect(width: 30mm, height: 18mm, fill: rgb(hex), radius: 2pt), + rect(width: 30mm, height: if slides { 12mm } else { 18mm }, fill: rgb(hex), radius: 2pt), [ *#name* \ #raw(hex) @@ -167,7 +184,7 @@ #let specimen(theme, family, role, sample, size: 24pt) = block( width: 100%, - inset: 12pt, + inset: if slides { 8pt } else { 12pt }, fill: white, radius: 4pt, stroke: (paint: theme.soft, thickness: 0.6pt), diff --git a/manual/main.typ b/manual/main.typ index e0fd62d..1f6c0c9 100644 --- a/manual/main.typ +++ b/manual/main.typ @@ -11,7 +11,9 @@ title: "LibreSign Brand Manual", author: "LibreSign contributors", ) -#set text(font: theme.body-font, lang: "en", size: 10.5pt, fill: theme.ink) +#let slides = sys.inputs.at("format", default: "a4") == "slides" +#set page(width: if slides { 338.667mm } else { 210mm }, height: if slides { 190.5mm } else { 297mm }) +#set text(font: theme.body-font, lang: "en", size: if slides { 12pt } else { 10.5pt }, fill: theme.ink) #set par(leading: 0.72em, spacing: 0.7em, justify: false) #set list(indent: 0pt, body-indent: 1.2em) #cover( @@ -275,7 +277,13 @@ gutter: 7mm, block(fill: white, inset: 7mm, height: 44mm)[ #align(center + horizon)[ - #image("../build/assets/libresign-logo-primary.svg", width: 82%, alt: "Primary full-color LibreSign logo") + #image( + "../build/assets/libresign-logo-primary.svg", + width: 82%, + height: 30mm, + fit: "contain", + alt: "Primary full-color LibreSign logo", + ) ] ], block(fill: theme.ink, inset: 7mm, height: 44mm)[ @@ -283,6 +291,8 @@ #image( "../build/assets/libresign-logo-reversed.svg", width: 82%, + height: 30mm, + fit: "contain", alt: "White LibreSign logo for dark backgrounds", ) ] @@ -290,7 +300,13 @@ block(fill: white, inset: 7mm, height: 44mm)[ #align(center + horizon)[ - #image("../build/assets/libresign-logo-monochrome.svg", width: 82%, alt: "Black one-color LibreSign logo") + #image( + "../build/assets/libresign-logo-monochrome.svg", + width: 82%, + height: 30mm, + fit: "contain", + alt: "Black one-color LibreSign logo", + ) ] ], [ @@ -312,9 +328,19 @@ #grid( columns: (1.15fr, 0.85fr), gutter: 10mm, - block(fill: white, inset: 10mm, height: 78mm)[ + block( + fill: white, + inset: if slides { 8mm } else { 10mm }, + height: if slides { 58mm } else { 78mm }, + )[ #align(center + horizon)[ - #image("../build/assets/libresign-logo-primary.svg", width: 84%, alt: "Official LibreSign logo composition") + #image( + "../build/assets/libresign-logo-primary.svg", + width: 84%, + height: if slides { 42mm } else { auto }, + fit: "contain", + alt: "Official LibreSign logo composition", + ) ] ], [ @@ -380,19 +406,19 @@ #manual-page(theme, [Visual system], [Digital palette])[ The product and website can use a wider digital color palette. These colors are separate from the colors inside the official logo. - #v(5mm) + #v(if slides { 2mm } else { 5mm }) #swatch("Primary Teal", "#184c4e", note: "Primary brand and interface field") - #v(4mm) + #v(if slides { 1mm } else { 4mm }) #swatch("Primary Hover", "#0f3739", note: "Interactive depth") - #v(4mm) + #v(if slides { 1mm } else { 4mm }) #swatch("Primary Dark", "#0b5f55", note: "Dark supporting teal") - #v(4mm) + #v(if slides { 1mm } else { 4mm }) #swatch("Secondary Cyan", "#00a3be", note: "Secondary digital accent") - #v(4mm) + #v(if slides { 1mm } else { 4mm }) #swatch("Light Surface", "#f7fafc", note: "Light background field") - #v(4mm) + #v(if slides { 1mm } else { 4mm }) #swatch("Dark Text", "#2d3748", note: "Readable text on light surfaces") - #v(6mm) + #v(if slides { 2mm } else { 6mm }) Colors for success, warnings, focus, and errors belong to the product design system and must be checked for accessibility in the place where they are used. ] @@ -477,35 +503,47 @@ #grid( columns: (1fr, 1fr), gutter: 7mm, - block(fill: white, inset: 8mm, height: 58mm)[ + block(fill: white, inset: if slides { 6mm } else { 8mm }, height: if slides { 44mm } else { 58mm })[ #align(center + horizon)[ - #image("../build/assets/libresign-logo-primary.svg", width: 78%, alt: "Primary LibreSign logo on white") + #image( + "../build/assets/libresign-logo-primary.svg", + width: 78%, + height: if slides { 30mm } else { auto }, + fit: "contain", + alt: "Primary LibreSign logo on white", + ) ] ], - block(fill: theme.soft, inset: 8mm, height: 58mm)[ + block(fill: theme.soft, inset: if slides { 6mm } else { 8mm }, height: if slides { 44mm } else { 58mm })[ #align(center + horizon)[ #image( "../build/assets/libresign-logo-primary.svg", width: 78%, + height: if slides { 30mm } else { auto }, + fit: "contain", alt: "Primary LibreSign logo on a light green field", ) ] ], - block(fill: theme.ink, inset: 8mm, height: 58mm)[ + block(fill: theme.ink, inset: if slides { 6mm } else { 8mm }, height: if slides { 44mm } else { 58mm })[ #align(center + horizon)[ #image( "../build/assets/libresign-logo-reversed.svg", width: 78%, + height: if slides { 30mm } else { auto }, + fit: "contain", alt: "White LibreSign logo on a dark neutral background", ) ] ], - block(fill: theme.accent, inset: 8mm, height: 58mm)[ + block(fill: theme.accent, inset: if slides { 6mm } else { 8mm }, height: if slides { 44mm } else { 58mm })[ #align(center + horizon)[ #image( "../build/assets/libresign-logo-reversed.svg", width: 78%, + height: if slides { 30mm } else { auto }, + fit: "contain", alt: "White LibreSign logo on the primary teal background", ) ] @@ -540,7 +578,7 @@ #manual-page(theme, [Usage], [Correct and incorrect use])[ Brand rules are easier to follow when correct and incorrect examples are visible. - #v(6mm) + #v(if slides { 2mm } else { 6mm }) #rule-pair( theme, [CORRECT], @@ -549,24 +587,32 @@ #image( "../build/assets/libresign-logo-primary.svg", width: 72%, + height: if slides { 18mm } else { auto }, + fit: "contain", alt: "Correct unmodified LibreSign logo on white", ) ] - #v(4mm) + #v(if slides { 1mm } else { 4mm }) Use the official artwork at its original proportions and preserve clear space. ], [DON'T ROTATE], [ #align(center)[ #rotate(8deg)[ - #image("../build/assets/libresign-logo-primary.svg", width: 72%, alt: "Incorrect rotated LibreSign logo") + #image( + "../build/assets/libresign-logo-primary.svg", + width: 72%, + height: if slides { 18mm } else { auto }, + fit: "contain", + alt: "Incorrect rotated LibreSign logo", + ) ] ] - #v(4mm) + #v(if slides { 1mm } else { 4mm }) Do not rotate, skew, distort, or otherwise reinterpret the mark. ], ) - #v(7mm) + #v(if slides { 2mm } else { 7mm }) #rule-pair( theme, [CORRECT CLEAR SPACE], @@ -576,11 +622,13 @@ #image( "../build/assets/libresign-logo-primary.svg", width: 72%, + height: if slides { 18mm } else { auto }, + fit: "contain", alt: "LibreSign logo with generous clear space", ) ] ] - #v(4mm) + #v(if slides { 1mm } else { 4mm }) Keep surrounding text, borders, and partner marks outside the exclusion area. ], [DON'T CROWD], @@ -593,12 +641,14 @@ image( "../build/assets/libresign-logo-primary.svg", width: 100%, + height: if slides { 18mm } else { auto }, + fit: "contain", alt: "LibreSign logo crowded by nearby text", ), text(font: theme.heading-font, size: 9pt, weight: "bold", fill: theme.ink)[PARTNER], ) ] - #v(4mm) + #v(if slides { 1mm } else { 4mm }) Do not place other content inside the required empty space around the logo. ], )