Formaat: een spreeknotitie die met "Woord:" begint laat de dia stil haar type verliezen

brenno commented

2026-08-27 16:41:29 +00:00

Owner

Wat er misgaat

requiresWholeMarpBlockPreservation in lib/services/marp_source_preservation.dart
ziet élk enkelregelig HTML-commentaar waarvan de inhoud matcht op
^[A-Za-z][A-Za-z0-9_-]*\s*: aan voor een onbekende Marp-directive, tenzij het
begint met advance:, tlp:, ocideck_ of _. Is er zo'n commentaar, dan valt
het hele diablok terug op SlideType.freeMarkdown.

Een gewone spreeknotitie is in het Nederlands (en Engels) vaak van precies die
vorm. Deze drie zijn genoeg:

<!-- Antwoord: onwaar. Herstel is alleen toegestaan voor verduidelijking. -->
<!-- Pareto: de balken staan gesorteerd, de gekleurde kop is de vitale minderheid. -->
<!-- Verdiepingsdia: valt weg in de beknopte export. -->

Gemeten op main (bcde8be6a), 2026-08-27. Een handgeschreven deck van 45
dia's met onder meer ,  en
. Drie dia's parsten als freeMarkdown in plaats van als
question/matrix/chart — precies de drie waarvan de notitie met Woord: begon.
Alleen die drie notities herschrijven (geen andere wijziging) herstelde alle
drie de types.

Voor de grafiekdia betekent dit dat de ```chart-fence als codeblok rendert in
plaats van als grafiek. Voor de vraagdia dat de quiz niet speelbaar is.

Waarom de heuristiek te breed is

Marpit honoreert alleen directives waarvan het de sleutel kent; een onbekende
sleutel wordt genegeerd. Een blok bewaren om Antwoord: is dus niet alleen
schadelijk, het is ook zinloos: Marp doet er zelf niets mee. De bewaarroute is
bedoeld voor sleutels die Marp wél honoreert maar OciDeck niet modelleert
(paginate, backgroundPosition, size, transition, class, …). De toets
hoort dan ook tegen die woordenlijst te gaan, niet tegen "elk woord gevolgd door
een dubbele punt".

Het tweede gat: de structuurcontrole zwijgt

MarkdownValidator.validate() levert op ditzelfde deck nul bevindingen,
terwijl drie dia's stil hun type verliezen. _reDirectiveKey daar kijkt bewust
alleen naar _- en ocideck_-voorvoegsels, dus de bare-word:-val valt buiten
beeld. Dit is precies het soort stille degradatie waarvoor §10 bestaat.

Wat het met het bestandsformaat doet

FILE_FORMAT.md §8 belooft: "Presenter notes — any other comment that does not
start with _". Die belofte klopt vandaag niet. Wie een deck met de hand
schrijft — of laat genereren — kan een dia stil kwijtraken op een notitie die
niets bijzonders is.

Toetsen

Een regressietest die een question- en een chart-dia met de notitie
 parseert en eist dat het diatype behouden blijft, en
een tegenhanger die aantoont dat een echte, niet-gemodelleerde Marp-directive
() het blok wél nog bewaart. Beide falen
vandaag de eerste kant op.

Verhouding tot #1810

Aangrenzend, maar een andere fout. #1810 gaat over onbekende ocideck_*-
directieven die een opslag niet overleven; dit gaat over prozanotities die
bij het lezen voor een Marp-directive worden aangezien. Ander pad, andere
reparatie, ze bijten elkaar niet.

**Wat er misgaat** `requiresWholeMarpBlockPreservation` in `lib/services/marp_source_preservation.dart` ziet élk enkelregelig HTML-commentaar waarvan de inhoud matcht op `^[A-Za-z][A-Za-z0-9_-]*\s*:` aan voor een onbekende Marp-directive, tenzij het begint met `advance:`, `tlp:`, `ocideck_` of `_`. Is er zo'n commentaar, dan valt het **hele diablok** terug op `SlideType.freeMarkdown`. Een gewone spreeknotitie is in het Nederlands (en Engels) vaak van precies die vorm. Deze drie zijn genoeg:    **Gemeten op `main` (bcde8be6a), 2026-08-27.** Een handgeschreven deck van 45 dia's met onder meer ``, `` en ``. Drie dia's parsten als `freeMarkdown` in plaats van als question/matrix/chart — precies de drie waarvan de notitie met `Woord:` begon. Alleen die drie notities herschrijven (geen andere wijziging) herstelde alle drie de types. Voor de grafiekdia betekent dit dat de ```chart-fence als codeblok rendert in plaats van als grafiek. Voor de vraagdia dat de quiz niet speelbaar is. **Waarom de heuristiek te breed is** Marpit honoreert alleen directives waarvan het de sleutel kent; een onbekende sleutel wordt genegeerd. Een blok bewaren om `Antwoord:` is dus niet alleen schadelijk, het is ook zinloos: Marp doet er zelf niets mee. De bewaarroute is bedoeld voor sleutels die Marp wél honoreert maar OciDeck niet modelleert (`paginate`, `backgroundPosition`, `size`, `transition`, `class`, …). De toets hoort dan ook tegen die woordenlijst te gaan, niet tegen "elk woord gevolgd door een dubbele punt". **Het tweede gat: de structuurcontrole zwijgt** `MarkdownValidator.validate()` levert op ditzelfde deck **nul bevindingen**, terwijl drie dia's stil hun type verliezen. `_reDirectiveKey` daar kijkt bewust alleen naar `_`- en `ocideck_`-voorvoegsels, dus de bare-`word:`-val valt buiten beeld. Dit is precies het soort stille degradatie waarvoor §10 bestaat. **Wat het met het bestandsformaat doet** `FILE_FORMAT.md` §8 belooft: *"Presenter notes — any other comment that does not start with `_`"*. Die belofte klopt vandaag niet. Wie een deck met de hand schrijft — of laat genereren — kan een dia stil kwijtraken op een notitie die niets bijzonders is. **Toetsen** Een regressietest die een `question`- en een `chart`-dia met de notitie `` parseert en eist dat het diatype behouden blijft, en een tegenhanger die aantoont dat een echte, niet-gemodelleerde Marp-directive (``) het blok wél nog bewaart. Beide falen vandaag de eerste kant op. **Verhouding tot #1810** Aangrenzend, maar een andere fout. #1810 gaat over onbekende `ocideck_*`- directieven die een **opslag** niet overleven; dit gaat over prozanotities die bij het **lezen** voor een Marp-directive worden aangezien. Ander pad, andere reparatie, ze bijten elkaar niet.

brenno added the

bug

in-progress

labels

2026-08-27 16:41:29 +00:00

brenno commented

2026-08-27 16:41:35 +00:00

Author

Owner

Opgepakt. Tak: fix/marp-notitie-directive (worktree). Verwachte reikwijdte: lib/services/marp_source_preservation.dart, lib/services/markdown_validator.dart (+ vocabulary), test/, docs/FILE_FORMAT.md §8/§9, CHANGELOG. Raakt #1810 niet: die zit in het schrijfpad voor onbekende ocideck_*-directieven, deze in de leesheuristiek voor Marp-directives.