Hoofdstukafbrekingen toepassen als bewerking van de body #1535

New issue

Closed

opened 2026-08-17 17:12:54 +00:00 by brenno · 1 comment

brenno commented

2026-08-17 17:12:54 +00:00

Owner

Uit het ontwerp van #1511, en het was het antwoord van de bewaker op mijn eigen vraag.

De instelling AppSettings.documentChapterPageBreak ("nieuw hoofdstuk op een nieuwe pagina") bepaalt de pagina-indeling en werkt door in de HTML-print en LaTeX, maar staat app-breed en reist niet mee met het document. Bij #1511 was de vraag of hij als vierde front-matter-sleutel mee moest.

Het antwoord was nee, en beter dan de vraag: FILE_FORMAT.md §14.6 kent al de juiste vorm. Een --- vóór een H1 is een pagina-einde dat élke lezer honoreert — pandoc, GitHub, de printer van de ontvanger. Dus geen privé-sleutel, maar een eenmalige bewerking van de body: "hoofdstukafbrekingen in dit document toepassen" zet die regels neer.

Zichtbaar, door de gebruiker terug te draaien, en het reist mee zonder dat OciDeck er iets voor hoeft te claimen.

Aandachtspunt: het moet idempotent zijn (twee keer toepassen mag geen dubbele --- opleveren) en het hoort de bestaande byte-getrouwheid te respecteren — dit is een bewerking van de tekst, dus hij verandert het bestand zichtbaar en met opzet.

Uit het ontwerp van #1511, en het was het antwoord van de bewaker op mijn eigen vraag. De instelling `AppSettings.documentChapterPageBreak` ("nieuw hoofdstuk op een nieuwe pagina") bepaalt de pagina-indeling en werkt door in de HTML-print en LaTeX, maar staat app-breed en reist niet mee met het document. Bij #1511 was de vraag of hij als vierde front-matter-sleutel mee moest. Het antwoord was nee, en beter dan de vraag: FILE_FORMAT.md §14.6 kent al de juiste vorm. Een `---` vóór een `H1` is een pagina-einde dat **élke** lezer honoreert — pandoc, GitHub, de printer van de ontvanger. Dus geen privé-sleutel, maar een eenmalige bewerking van de body: "hoofdstukafbrekingen in dit document toepassen" zet die regels neer. Zichtbaar, door de gebruiker terug te draaien, en het reist mee zonder dat OciDeck er iets voor hoeft te claimen. Aandachtspunt: het moet idempotent zijn (twee keer toepassen mag geen dubbele `---` opleveren) en het hoort de bestaande byte-getrouwheid te respecteren — dit is een bewerking van de tekst, dus hij verandert het bestand zichtbaar en met opzet.

brenno added the

enhancement

label

2026-08-17 17:12:54 +00:00

brenno referenced this issue from a commit

2026-08-17 22:55:56 +00:00

feat(documentmodus): pure bronbewerking voor hoofdstukafbrekingen

brenno referenced this issue from a commit

2026-08-17 22:55:56 +00:00

feat(documentmodus): knop 'Hoofdstukken op nieuwe pagina' in het palet

brenno referenced this issue from a commit

2026-08-17 22:55:56 +00:00