docs(formaat): de mermaid-fence vastgelegd in FILE_FORMAT en KNOWN_LIMITATIONS (#1923) #1930

Merged

brenno merged 3 commits from docs/mermaid-file-format into main

2026-09-02 23:49:05 +00:00

brenno commented

2026-09-02 23:10:25 +00:00

Owner

Closes #1923.

Drie gaten rond de mermaid-fence gedicht, in het Engels én het Nederlands.

§14 noemde de fence nergens, terwijl OciDeck hem in zes weergaven tekent. De nieuwe §14.13 legt vast dat het gewone, draagbare Markdown is, en welke renderregels eraan hangen.

§14.11 zegt nu dat de tijdlijntabel de chronologievorm is die in élke weergave werkt — precies het contrast met de fence hierboven.

KNOWN_LIMITATIONS noemt de grafiek-fence als het blok dat in de visuele editor nog brontekst blijft, nu mermaid dat sinds #1920 niet meer is.

Elke renderregel is tegen de code nagelezen, niet uit de issuetekst overgenomen. htmlLabels: false, securityLevel: strict en de zes onaantastbare secure-sleutels staan in services/mermaid_config.dart; de allow-list in utils/sanitize_svg.dart laat style, marker, filter en foreignObject inderdaad vallen — vandaar pijlpunten als gebakken polygonen.

Drie beweringen uit het issue klopten niet en staan hier anders:

"Tekening op ware grootte" geldt alleen nog voor de lezer. Sinds #1921 schalen Pagina's en PDF juist naar de kolom.
De terugval op een codeblok geldt niet op web — dat pad tekent via de gebundelde mermaid.min.js — maar op Windows en Linux, waar de WebView geen platformimplementatie heeft.
Blokformules staan er niet in. De documentlezer kent maar twee bijzondere fences, mermaid en chart (document_markdown_view.dart:540); in documentmodus bestaat er geen formuleblok om over te melden.

De vertaalpoort ving onderweg terecht dat mijn voorbeelddiagram in beide talen identiek was; de labels zijn proza en staan nu per taal.

Bewaker overgeslagen, expliciet: dit legt bestaand gedrag vast en belooft niets nieuws. De enige claim die verandert is er één die naar beneden wordt bijgesteld.

🤖 Generated with Claude Code

Closes #1923. Drie gaten rond de mermaid-fence gedicht, in het Engels én het Nederlands. **§14 noemde de fence nergens**, terwijl OciDeck hem in zes weergaven tekent. De nieuwe §14.13 legt vast dat het gewone, draagbare Markdown is, en welke renderregels eraan hangen. **§14.11** zegt nu dat de tijdlijntabel de chronologievorm is die in élke weergave werkt — precies het contrast met de fence hierboven. **KNOWN_LIMITATIONS** noemt de grafiek-fence als het blok dat in de visuele editor nog brontekst blijft, nu mermaid dat sinds #1920 niet meer is. **Elke renderregel is tegen de code nagelezen, niet uit de issuetekst overgenomen.** `htmlLabels: false`, `securityLevel: strict` en de zes onaantastbare `secure`-sleutels staan in `services/mermaid_config.dart`; de allow-list in `utils/sanitize_svg.dart` laat `style`, `marker`, `filter` en `foreignObject` inderdaad vallen — vandaar pijlpunten als gebakken polygonen. **Drie beweringen uit het issue klopten niet en staan hier anders:** 1. "Tekening op ware grootte" geldt alleen nog voor de lezer. Sinds #1921 schalen Pagina's en PDF juist naar de kolom. 2. De terugval op een codeblok geldt niet op web — dat pad tekent via de gebundelde `mermaid.min.js` — maar op Windows en Linux, waar de WebView geen platformimplementatie heeft. 3. Blokformules staan er niet in. De documentlezer kent maar twee bijzondere fences, `mermaid` en `chart` (`document_markdown_view.dart:540`); in documentmodus bestaat er geen formuleblok om over te melden. De vertaalpoort ving onderweg terecht dat mijn voorbeelddiagram in beide talen identiek was; de labels zijn proza en staan nu per taal. **Bewaker overgeslagen, expliciet:** dit legt bestaand gedrag vast en belooft niets nieuws. De enige claim die verandert is er één die naar beneden wordt bijgesteld. 🤖 Generated with [Claude Code](https://claude.com/claude-code)

brenno added 3 commits

2026-09-02 23:10:26 +00:00

docs(formaat): de mermaid-fence vastgelegd in FILE_FORMAT en KNOWN_LIMITATIONS (#1923 ) 4a8a0d06c8

Drie gaten rond de mermaid-fence gedicht.

§14 noemde de fence nergens, terwijl OciDeck hem in zes weergaven tekent.
De nieuwe §14.13 legt vast dat het gewone, draagbare Markdown is, en welke
renderregels eraan hangen: htmlLabels uit, securityLevel strict met zes
onaantastbare secure-sleutels, en een allow-list die style, marker, filter
en foreignObject laat vallen — vandaar pijlpunten als gebakken polygonen.
Elk van die regels is tegen mermaid_config.dart en sanitize_svg.dart
nagelezen, niet uit de issuetekst overgenomen.

Twee dingen uit die issuetekst klopten niet meer en staan hier anders. De
tekening is niet overal op ware grootte: sinds #1921 schalen Pagina's en
PDF juist naar de kolom, en alleen de lezer schuift horizontaal. En de
terugval geldt niet op web — dat pad tekent via de gebundelde
mermaid.min.js — maar op Windows en Linux, waar de WebView geen
implementatie heeft.

§14.11 zegt nu dat de tijdlijntabel de chronologievorm is die in élke
weergave werkt; dat is precies het contrast met de fence hierboven.

KNOWN_LIMITATIONS noemt de grafiek-fence als het blok dat in de visuele
editor nog brontekst blijft. Niet de blokformule: de documentlezer kent
maar twee bijzondere fences, mermaid en chart, dus in documentmodus bestaat
er geen formuleblok om over te melden.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

docs(nl): de mermaid-secties in de Nederlandse varianten (#1923 ) d8a349a881

De vertaalpoort eist de nieuwe secties in dezelfde wijziging; een sectie
houdt zijn nummer in elke taal.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

docs: het voorbeelddiagram in de Engelse variant ook in het Engels (#1923 )

scans / scans (pull_request) Successful in 3m1s

Details

static-gate / static-gate (pull_request) Successful in 7m28s

Details

a66dfe429c

De vertaalpoort ving het: identieke mermaid-blokken in twee talen betekent
een onvertaald diagram. Terecht — de labels zijn proza.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

brenno merged commit a9f0e5dfd5 into main

2026-09-02 23:49:05 +00:00

brenno referenced this pull request from a commit

2026-09-02 23:49:06 +00:00

Merge pull request 'docs(formaat): de mermaid-fence vastgelegd in FILE_FORMAT en KNOWN_LIMITATIONS (#1923)' (#1930) from docs/mermaid-file-format into main

brenno referenced this pull request

2026-09-02 23:49:27 +00:00

Documentatie: mermaid-fence ontbreekt in FILE_FORMAT.md §14 en visueel-editor-limiet in KNOWN_LIMITATIONS.md #1923