docs(export): leg vast dat de HTML-export de dia-overlays weglaat (#1330) #1335

Merged

brenno merged 1 commit from docs/web-export-overlay-boundary into main

2026-08-07 16:38:06 +00:00

brenno commented

2026-08-07 16:20:14 +00:00

Owner

Vervolg op de beeldkeuring bij #1330: daar bleek dat de eigen footertekst en paginanummering uit het themaprofiel niet in de single-file HTML-export komen — in de gegenereerde HTML kwam "chateau" 0× voor.

Onderzocht en getoetst tegen de daadwerkelijk gegenereerde HTML (niet tegen de aanname): dit is geen op zichzelf staande bug maar een bewuste grens. De HTML-export reproduceert de héle overlaylaag niet:

Overlay	Editor / presentatie / PDF	HTML-export
Footertekst + paginanummer	✅	❌
Logo	✅	❌
Diagonaal classificatie-watermerk	✅	❌
Per-dia TLP-badge	✅	❌
PrivacyKat-badge	✅	❌
Classificatie	per-dia badge	✅ als documentbanner bovenaan

Die laag hoort bij OciDeck's eigen slide-renderer (waar PDF/PPTX ook doorheen gaan), niet bij de Markdown die de HTML-export inbedt voor een in-browser renderer. De veiligheidskritische classificatie reist wél mee, als banner. Een gedeeltelijke footer-reproductie zou bovendien afwijken van app/PDF (per-dia showFooter, {title}/{date}-tokens, nummering) en zo méér verwarring geven dan een heldere, gedocumenteerde grens.

Besluit: documenteren, niet bouwen.

docs/KNOWN_LIMITATIONS.md: nieuwe sectie "The web (HTML) export leaves off the on-slide overlays".
docs/USER_GUIDE.md: aantekening in de export-sectie, met verwijzing en het advies om PDF/PPTX te gebruiken als de ontvanger de footer/paginanummers nodig heeft.
Development log-aantekening.

Docs-only; check-translated-mermaid groen. (De vertaalde .md-varianten worden door de maintainer geregenereerd met make translate-docs; het Engelse bestand is leidend.)

Terzijde, buiten deze PR: dart run tool/translate_docs.dart --check crasht lokaal op een Dart FFI-compilerfout (InvalidType/FunctionType) — reproduceert óók op schone main, dus een bestaand omgevings-/toolchainprobleem, niet door deze wijziging veroorzaakt en geen per-PR-poort.

Vervolg op de beeldkeuring bij #1330: daar bleek dat de eigen **footertekst** en **paginanummering** uit het themaprofiel niet in de single-file **HTML-export** komen — in de gegenereerde HTML kwam "chateau" 0× voor. **Onderzocht en getoetst tegen de daadwerkelijk gegenereerde HTML** (niet tegen de aanname): dit is geen op zichzelf staande bug maar een **bewuste grens**. De HTML-export reproduceert de héle overlaylaag niet: | Overlay | Editor / presentatie / PDF | HTML-export | |---|---|---| | Footertekst + paginanummer | ✅ | ❌ | | Logo | ✅ | ❌ | | Diagonaal classificatie-watermerk | ✅ | ❌ | | Per-dia TLP-badge | ✅ | ❌ | | PrivacyKat-badge | ✅ | ❌ | | **Classificatie** | per-dia badge | ✅ **als documentbanner bovenaan** | Die laag hoort bij OciDeck's eigen slide-renderer (waar PDF/PPTX ook doorheen gaan), niet bij de Markdown die de HTML-export inbedt voor een in-browser renderer. De veiligheidskritische classificatie reist wél mee, als banner. Een gedeeltelijke footer-reproductie zou bovendien afwijken van app/PDF (per-dia `showFooter`, `{title}`/`{date}`-tokens, nummering) en zo méér verwarring geven dan een heldere, gedocumenteerde grens. **Besluit: documenteren, niet bouwen.** - `docs/KNOWN_LIMITATIONS.md`: nieuwe sectie "The web (HTML) export leaves off the on-slide overlays". - `docs/USER_GUIDE.md`: aantekening in de export-sectie, met verwijzing en het advies om PDF/PPTX te gebruiken als de ontvanger de footer/paginanummers nodig heeft. - Development log-aantekening. Docs-only; `check-translated-mermaid` groen. (De vertaalde `.md`-varianten worden door de maintainer geregenereerd met `make translate-docs`; het Engelse bestand is leidend.) Terzijde, buiten deze PR: `dart run tool/translate_docs.dart --check` crasht lokaal op een Dart FFI-compilerfout (`InvalidType`/`FunctionType`) — reproduceert óók op schone `main`, dus een bestaand omgevings-/toolchainprobleem, niet door deze wijziging veroorzaakt en geen per-PR-poort.

brenno force-pushed docs/web-export-overlay-boundary from 2c8826ad87

scans / scans (pull_request) Successful in 1m39s

Details

static-gate / static-gate (pull_request) Successful in 4m36s

Details

to 95e44b3e26

scans / scans (pull_request) Successful in 3m31s

Details

static-gate / static-gate (pull_request) Successful in 8m0s

Details

2026-08-07 16:29:35 +00:00

Compare