report/
report.rs

1//! Example: a report/certificate-style document — cover page (header
2//! suppressed via `.header_visible_from(2)`), heading presets, a `List`,
3//! and an optional watermark. (Phase 6 DoD, `plan/phases/phase-6-business-
4//! polish.md`.)
5//!
6//! Also demonstrates `Document::theme(..)` (issue #16): headings get a
7//! brand color and the cover subtitle uses `.muted()` — set once, here,
8//! instead of a `.color(..)` call on every heading this document adds.
9//!
10//! Run: `cargo run -p lightweight-pdf --example report`
11
12use lightweight_pdf::*;
13
14#[path = "common/mod.rs"]
15mod common;
16
17/// A brand-colored variant of the default theme — only `heading1`/
18/// `heading2`/`heading3` differ from `Theme::default()`, so every
19/// `.heading1()`/`.heading2()`/`.heading3()` in this document picks up
20/// the accent color automatically; nothing else about them (size, bold,
21/// `keep_with_next`, outline level) changes.
22fn brand_theme() -> Theme {
23    let accent = Color::rgb(0x1a, 0x3c, 0x6e);
24    let defaults = Theme::default();
25    Theme {
26        heading1: TextStyle {
27            color: accent,
28            ..defaults.heading1
29        },
30        heading2: TextStyle {
31            color: accent,
32            ..defaults.heading2
33        },
34        heading3: TextStyle {
35            color: accent,
36            ..defaults.heading3
37        },
38        ..defaults
39    }
40}
41
42fn main() {
43    let mut doc = Document::new(PageFormat::A4)
44        .margin(Margin::symmetric(56.0, 56.0))
45        .theme(brand_theme())
46        .header(Header::new(20.0, |_ctx| {
47            Text::new("Jahresbericht 2026 \u{2014} Muster GmbH").size(9.0).into()
48        }))
49        .header_visible_from(2)
50        .footer(Footer::new(20.0, |ctx| {
51            Text::new(format!("Seite {} von {}", ctx.page, ctx.total_pages))
52                .size(9.0)
53                .align(Align::Center)
54                .into()
55        }))
56        .watermark(Watermark::new("ENTWURF"));
57
58    // --- cover page -----------------------------------------------------
59    doc.add(Spacer::new(220.0));
60    doc.add(Text::new("Jahresbericht 2026").heading1().align(Align::Center));
61    doc.add(Spacer::new(8.0));
62    doc.add(Text::new("Muster GmbH").align(Align::Center));
63    doc.add(Text::new("vorgelegt am 20. August 2026").muted().align(Align::Center));
64    doc.add(Element::PageBreak);
65
66    // --- content ---------------------------------------------------------
67    doc.add(Text::new("1. Zusammenfassung").heading1());
68    doc.add(Text::new(
69        "Das Geschäftsjahr 2026 war geprägt von stabilem Wachstum in allen \
70         Kernbereichen. Die folgenden Abschnitte fassen die wichtigsten \
71         Kennzahlen und Entwicklungen zusammen.",
72    ));
73    doc.add(Spacer::new(12.0));
74
75    doc.add(Text::new("2. Wichtigste Ereignisse").heading2());
76    doc.add(
77        List::new()
78            .bullet(Text::new("Markteinführung des neuen Produkts im zweiten Quartal"))
79            .bullet(Text::new("Erweiterung des Teams um 12 neue Mitarbeitende"))
80            .bullet(Text::new("Eröffnung eines zweiten Standorts")),
81    );
82    doc.add(Spacer::new(12.0));
83
84    doc.add(Text::new("3. Zeitplan").heading2());
85    doc.add(
86        List::new()
87            .numbered(Text::new("Kickoff und Planung (Januar \u{2013} Februar)"))
88            .numbered(Text::new("Umsetzung Phase 1 (M\u{e4}rz \u{2013} Juni)"))
89            .numbered(Text::new("Umsetzung Phase 2 (Juli \u{2013} Oktober)"))
90            .numbered(Text::new("Abschluss und Auswertung (November \u{2013} Dezember)")),
91    );
92    doc.add(Spacer::new(12.0));
93
94    doc.add(Text::new("3.1 Details").heading3());
95    doc.add(Text::new(
96        "Weitere Details zu den einzelnen Phasen finden sich im Anhang. \
97         Diese Überschrift bleibt dank keep_with_next garantiert mit \
98         diesem Absatz auf derselben Seite zusammen.",
99    ));
100
101    common::write_pdf(&doc, "report.pdf");
102}
report/report.rs

report/
report.rs
