rusdox 1.0.0

Generate DOCX and PDF from YAML at Rust speed.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94

# Template Gallery

These previews are generated from the real PDF outputs in `rendered/`.

That means the gallery shows actual RusDox output, not mockups.

Each featured example also opens in the local-first browser playground. The
playground gives an immediate structural preview; its verified DOCX/PDF links
are enabled only while the checked-in YAML is unchanged.

![Template gallery overview](../assets/template-gallery.png)

## Board Report

![Board Report preview](../assets/gallery/board-report.png)

- Spec: [../examples/board_report.yaml](../examples/board_report.yaml)
- Playground: [Open this example](https://othmaneblial.github.io/rusdox/playground/?example=board-report)
- Evidence: [DOCX/PDF parity report](../parity/board-report-parity.html)
- Output: board-style packet with cover page, metrics, and scorecard tables

## Executive Dashboard

![Executive Dashboard preview](../assets/gallery/executive-dashboard.png)

- Spec: [../examples/executive_dashboard.yaml](../examples/executive_dashboard.yaml)
- Playground: [Open this example](https://othmaneblial.github.io/rusdox/playground/?example=executive-dashboard)
- Evidence: [DOCX/PDF parity report](../parity/executive-dashboard-parity.html)
- Output: dashboard-style summary with metrics and status tables

## Product Launch Brief

![Product Launch Brief preview](../assets/gallery/product-launch-brief.png)

- Spec: [../examples/product_launch_brief.yaml](../examples/product_launch_brief.yaml)
- Playground: [Open this example](https://othmaneblial.github.io/rusdox/playground/?example=product-launch-brief)
- Evidence: [DOCX/PDF parity report](../parity/product-launch-brief-parity.html)
- Output: launch narrative with milestones and readiness checks

## Talent Profile

![Talent Profile preview](../assets/gallery/talent-profile.png)

- Spec: [../examples/talent_profile.yaml](../examples/talent_profile.yaml)
- Playground: [Open this example](https://othmaneblial.github.io/rusdox/playground/?example=talent-profile)
- Evidence: [DOCX/PDF parity report](../parity/talent-profile-parity.html)
- Output: profile or resume-style document

## Invoice

![Invoice preview](../assets/gallery/invoice.png)

- Spec: [../examples/invoice.yaml](../examples/invoice.yaml)
- Playground: [Open this example](https://othmaneblial.github.io/rusdox/playground/?example=invoice)
- Evidence: [DOCX/PDF parity report](../parity/invoice-parity.html)
- Output: invoice layout with line items and totals

## Meeting Notes

![Meeting Notes preview](../assets/gallery/meeting-notes.png)

- Spec: [../examples/meeting_notes.yaml](../examples/meeting_notes.yaml)
- Playground: [Open this example](https://othmaneblial.github.io/rusdox/playground/?example=meeting-notes)
- Evidence: [DOCX/PDF parity report](../parity/meeting-notes-parity.html)
- Output: compact notes with metadata, agenda, and decisions

## Contract Fixtures

These fixtures exercise the less visible parts of the dual-output contract. Their reports are generated from the real DOCX and PDF outputs alongside the visual gallery reports.

### Complete Dual-Output Contract

- Spec: [../examples/dual_output_contract.yaml](../examples/dual_output_contract.yaml)
- Evidence: [DOCX/PDF parity report](../parity/dual-output-contract-parity.html)
- Coverage: shared landscape geometry, visible page fields, breaks, URI and internal links, bookmarks, TOC, footnotes, rich/merged/nested cells, and row pagination controls

### International Scripts

- Spec: [../examples/international_scripts.yaml](../examples/international_scripts.yaml)
- Evidence: [DOCX/PDF parity report](../parity/international-scripts-parity.html)
- Coverage: Unicode preservation and fallback across Latin, Arabic/RTL, Hebrew, CJK, emoji, and mixed-script text; see the compatibility matrix for shaping limits

### Visual Accessibility

- Spec: [../examples/visual_assets_showcase.yaml](../examples/visual_assets_showcase.yaml)
- Evidence: [DOCX/PDF parity report](../parity/visual-assets-showcase-parity.html)
- Coverage: required meaningful alt text preserved across source, reopened DOCX, and PDF semantic projection

## Regenerate Gallery Assets

```bash
./scripts/generate_gallery_assets.sh
./scripts/generate_parity_reports.sh
```