Herhaalde front matter-blokken in bronbestand lekken als zichtbare tekst in PDF-export #1726

New issue

Closed

opened 2026-08-22 19:20:27 +00:00 by brenno · 0 comments

brenno commented

2026-08-22 19:20:27 +00:00

Owner

Wat is het probleem?

Wanneer een .md-bronbestand meerdere ----front matter-blokken bevat (het eerste correct afgesloten, daarna losse herhalingen van sleutel-waarde-regels), worden de herhalingen ná het eerste blok als gewone Markdown-tekst gerenderd. In de geëxporteerde PDF verschijnen ze dan als zichtbare tekst boven de titel op pagina 1.

Hoe te reproduceren

Maak of bewerk een document-Markdownbestand met de volgende inhoud:

---
theme: Vigilis
tlp: amber
---
theme: Vigilis
tlp: amber
---
theme: Vigilis
tlp: amber
---
# Mijn titel

Lopende tekst...

Exporteer naar PDF.
Bekijk pagina 1.

Verwacht gedrag

OciDeck herkent dat de regels ná het eerste front matter-blok die eruitzien als front matter-sleutels (theme:, tlp:, etc.) géén normale documentinhoud zijn, en negeert ze of voegt ze samen met het eerste blok. In de PDF verschijnt alleen de titel en de lopende tekst.

Werkelijk gedrag

De regels theme: Vigilis en tlp: amber (twee keer herhaald) verschijnen als zichtbare tekst boven de titel op pagina 1 van de PDF.

Root cause

De front matter-parser stipt alleen het allereerste ---...----blok. Alles daarna wordt als documentbody behandeld, ook als het eruitziet als front matter. Het bronbestand dat dit aan het licht bracht (incidentrapport-rwm-onjuiste-maprechten-q-schijf-2026-07-31.md) bevat drie herhaalde blokken:

---
theme: Vigilis
tlp: amber
---
theme: Vigilis
tlp: amber
---
theme: Vigilis
tlp: amber
---
# Incidentrapport RWM...

Dit kan twee oorzaken hebben:

Opslagbug: OciDeck voegt bij elke opslag een front matter-blok toe zonder de bestaande te strippen, waardoor herhalingen opstapelen. Het bestand heeft ook geen marp: true (normaal de eerste regel die OciDeck schrijft), wat suggereert dat het deels met de hand of met een andere tool is aangemaakt.
Handmatig toegevoegd: De auteur heeft de front matter handmatig gekopieerd.

In beide gevallen hoort de export robuust te zijn: losse front matter-achtige regels ná het eerste blok horen niet als zichtbare tekst in de uitvoer te belanden.

Voorgestelde oplossing

Twee sporen:

Export-robustness: De document-naar-markdown-omzetting (DocumentDeckBridge.documentToDeck of de front matter-strip in markdown_service.dart) hoort óók herhalingen van front matter-achtige regels direct ná het eerste blok te herkennen en te negeren, niet alleen het eerste ---...----blok.
Opslag-onderzoek: Onderzoek of de opslagroute (front_matter_merge.dart / markdown_service.dart) bij herhaald opslaan front matter kan opstapelen. Het bestand in kwestie mist marp: true, wat een aanwijzing is dat het niet via de normale OciDeck-opslagroute is ontstaan.

Voorbeeld

In de bijgevoegde PDF (Incidentrapport RWM) staat op pagina 1 boven de titel:

theme: Vigilis
tlp: amber

theme: Vigilis
tlp: amber

Labels

bug, accepted

## Wat is het probleem? Wanneer een `.md`-bronbestand meerdere `---`-front matter-blokken bevat (het eerste correct afgesloten, daarna losse herhalingen van sleutel-waarde-regels), worden de herhalingen ná het eerste blok als gewone Markdown-tekst gerenderd. In de geëxporteerde PDF verschijnen ze dan als zichtbare tekst boven de titel op pagina 1. ## Hoe te reproduceren 1. Maak of bewerk een document-Markdownbestand met de volgende inhoud: ```markdown --- theme: Vigilis tlp: amber --- theme: Vigilis tlp: amber --- theme: Vigilis tlp: amber --- # Mijn titel Lopende tekst... ``` 2. Exporteer naar PDF. 3. Bekijk pagina 1. ## Verwacht gedrag OciDeck herkent dat de regels ná het eerste front matter-blok die eruitzien als front matter-sleutels (`theme:`, `tlp:`, etc.) géén normale documentinhoud zijn, en negeert ze of voegt ze samen met het eerste blok. In de PDF verschijnt alleen de titel en de lopende tekst. ## Werkelijk gedrag De regels `theme: Vigilis` en `tlp: amber` (twee keer herhaald) verschijnen als zichtbare tekst boven de titel op pagina 1 van de PDF. ## Root cause De front matter-parser stipt alleen het allereerste `---...---`-blok. Alles daarna wordt als documentbody behandeld, ook als het eruitziet als front matter. Het bronbestand dat dit aan het licht bracht (`incidentrapport-rwm-onjuiste-maprechten-q-schijf-2026-07-31.md`) bevat drie herhaalde blokken: ``` --- theme: Vigilis tlp: amber --- theme: Vigilis tlp: amber --- theme: Vigilis tlp: amber --- # Incidentrapport RWM... ``` Dit kan twee oorzaken hebben: 1. **Opslagbug:** OciDeck voegt bij elke opslag een front matter-blok toe zonder de bestaande te strippen, waardoor herhalingen opstapelen. Het bestand heeft ook geen `marp: true` (normaal de eerste regel die OciDeck schrijft), wat suggereert dat het deels met de hand of met een andere tool is aangemaakt. 2. **Handmatig toegevoegd:** De auteur heeft de front matter handmatig gekopieerd. In beide gevallen hoort de export robuust te zijn: losse front matter-achtige regels ná het eerste blok horen niet als zichtbare tekst in de uitvoer te belanden. ## Voorgestelde oplossing Twee sporen: 1. **Export-robustness:** De document-naar-markdown-omzetting (`DocumentDeckBridge.documentToDeck` of de front matter-strip in `markdown_service.dart`) hoort óók herhalingen van front matter-achtige regels direct ná het eerste blok te herkennen en te negeren, niet alleen het eerste `---...---`-blok. 2. **Opslag-onderzoek:** Onderzoek of de opslagroute (`front_matter_merge.dart` / `markdown_service.dart`) bij herhaald opslaan front matter kan opstapelen. Het bestand in kwestie mist `marp: true`, wat een aanwijzing is dat het niet via de normale OciDeck-opslagroute is ontstaan. ## Voorbeeld In de bijgevoegde PDF (Incidentrapport RWM) staat op pagina 1 boven de titel: ``` theme: Vigilis tlp: amber theme: Vigilis tlp: amber ``` ## Labels bug, accepted

brenno added the

accepted

bug

in-progress

labels

2026-08-22 19:20:56 +00:00

brenno referenced this issue from a commit

2026-08-22 19:47:18 +00:00

fix(pdf): tijdlijn-rail, TLP-badge, front matter-lekkage en woordafbreking (#1724 #1725 #1726 #1727)

brenno referenced this issue

2026-08-22 19:48:19 +00:00

fix(pdf): tijdlijn-rail, TLP-badge, front matter-lekkage en woordafbreking (#1724 #1725 #1726 #1727) #1728