BlueGit

projects-timfalken-com verhalenboek

feat: render wiki Markdown and move API keys onto Beheer

Wiki chapters keep their ## anchors and [[links]], and now also render
lists, emphasis, code, quotes and safe external links. The Sleutels tab
moves to the bottom of Beheer; #/sleutels opens that same page.

Co-authored-by: tim <tim@timfalken.com>

timfa project_87242033_bot_b167a9be22027ad5a4b431d0ad8426c6 · pushed by timfa

Authored 2026-10-11 · 5 weeks ago

Hash
4388c66f9dcf30434aad1903a295d1f10b1c4db5
Parent
80ed7ffa
10 files changed +864 −74
README.md +2 −2
@@ -41,7 +41,7 @@ return [
41 41 Lege velden voor URL en client vallen terug op `VERHALENBOEK_BASE_URL`, `VERHALENBOEK_CLIENT_ID` en `VERHALENBOEK_CLIENT_SECRET`. Een ingevuld veld wint van de omgeving. `base_url` mag een submap bevatten en heeft geen slash aan het eind. `key_secret` komt niet uit de omgeving.
42 42
43 43 5. Log als eerste zelf in. Die eerste gebruiker wordt beheerder. Iedereen daarna is lezer. Het account-id en de gebruikersnaam komen uit `/api/me`. E-mail wordt niet gelezen en niet opgeslagen. Onder **Beheer** zie je alle gebruikers. Daar maak je iemand anders beheerder, of haal je die rol weer weg. Je kunt je eigen beheerdersrol niet uitzetten, zodat er altijd minstens één beheerder blijft.
44 6. Maak onder **Sleutels** een API-sleutel voor de schrijver-agent. De volledige sleutel (`vb_…`) verschijnt meteen, en daarna opnieuw als je op die sleutel tikt. Alleen een ingelogde beheerder ziet dat; de lijst en de export tonen alleen het voorvoegsel.
44 6. Maak onderaan **Beheer** een API-sleutel voor de schrijver-agent. De volledige sleutel (`vb_…`) verschijnt meteen, en daarna opnieuw als je op die sleutel tikt. Alleen een ingelogde beheerder ziet dat; de lijst en de export tonen alleen het voorvoegsel. Een oud adres `#/sleutels` komt op diezelfde Beheer-pagina uit.
45 45
46 46 De OAuth-flow is dezelfde als bij microchess: `state`, code wisselen op de server via `POST /oauth/token`, daarna `GET /api/me`, verlengen via `POST /api/session/extend`, en afmelden via `POST /api/logout`. Het bearer-token van het account blijft in de PHP-sessie en komt niet in JavaScript.
47 47
@@ -112,7 +112,7 @@ curl -sS -H 'Authorization: Bearer vb_JOUW_SLEUTEL' \
112 112
113 113 Fouten zijn `{"error":"…"}`. Validatie die de drie-verhalenregel raakt geeft 422. De menselijke uitleg met dezelfde voorbeelden staat op `docs.php`.
114 114
115 Een 401 (geen header, verkeerd formaat, of een onbekende/ingetrokken sleutel) zet `WWW-Authenticate: Bearer` en voegt `how_to_authenticate` toe, met dezelfde tekst in `hint`. Die tekst noemt het geval, de header `Authorization: Bearer vb_…`, Sleutels op `{base_url}/#/sleutels`, en een link naar `docs.php`. Een 403 omdat een lezer iets doet dat een sleutel of beheerder vereist, heeft die uitleg ook, zonder `WWW-Authenticate`. Sleutels zelf beheren kan alleen in de beheerderssessie. Een 403 door een ongeldige CSRF-header blijft alleen `{"error":"…"}`.
115 Een 401 (geen header, verkeerd formaat, of een onbekende/ingetrokken sleutel) zet `WWW-Authenticate: Bearer` en voegt `how_to_authenticate` toe, met dezelfde tekst in `hint`. Die tekst noemt het geval, de header `Authorization: Bearer vb_…`, Beheer op `{base_url}/#/beheer`, en een link naar `docs.php`. Een 403 omdat een lezer iets doet dat een sleutel of beheerder vereist, heeft die uitleg ook, zonder `WWW-Authenticate`. Sleutels zelf beheren kan alleen in de beheerderssessie, onderaan Beheer. Een 403 door een ongeldige CSRF-header blijft alleen `{"error":"…"}`.
116 116
117 117 ```sh
118 118 curl -sS -D - -o - \
@@ -41,7 +41,7 @@ return [
41Lege velden voor URL en client vallen terug op `VERHALENBOEK_BASE_URL`, `VERHALENBOEK_CLIENT_ID` en `VERHALENBOEK_CLIENT_SECRET`. Een ingevuld veld wint van de omgeving. `base_url` mag een submap bevatten en heeft geen slash aan het eind. `key_secret` komt niet uit de omgeving.
41Lege velden voor URL en client vallen terug op `VERHALENBOEK_BASE_URL`, `VERHALENBOEK_CLIENT_ID` en `VERHALENBOEK_CLIENT_SECRET`. Een ingevuld veld wint van de omgeving. `base_url` mag een submap bevatten en heeft geen slash aan het eind. `key_secret` komt niet uit de omgeving.
42
42
435. Log als eerste zelf in. Die eerste gebruiker wordt beheerder. Iedereen daarna is lezer. Het account-id en de gebruikersnaam komen uit `/api/me`. E-mail wordt niet gelezen en niet opgeslagen. Onder **Beheer** zie je alle gebruikers. Daar maak je iemand anders beheerder, of haal je die rol weer weg. Je kunt je eigen beheerdersrol niet uitzetten, zodat er altijd minstens één beheerder blijft.
435. Log als eerste zelf in. Die eerste gebruiker wordt beheerder. Iedereen daarna is lezer. Het account-id en de gebruikersnaam komen uit `/api/me`. E-mail wordt niet gelezen en niet opgeslagen. Onder **Beheer** zie je alle gebruikers. Daar maak je iemand anders beheerder, of haal je die rol weer weg. Je kunt je eigen beheerdersrol niet uitzetten, zodat er altijd minstens één beheerder blijft.
446. Maak onder **Sleutels** een API-sleutel voor de schrijver-agent. De volledige sleutel (`vb_…`) verschijnt meteen, en daarna opnieuw als je op die sleutel tikt. Alleen een ingelogde beheerder ziet dat; de lijst en de export tonen alleen het voorvoegsel.
446. Maak onderaan **Beheer** een API-sleutel voor de schrijver-agent. De volledige sleutel (`vb_…`) verschijnt meteen, en daarna opnieuw als je op die sleutel tikt. Alleen een ingelogde beheerder ziet dat; de lijst en de export tonen alleen het voorvoegsel. Een oud adres `#/sleutels` komt op diezelfde Beheer-pagina uit.
45
45
46De OAuth-flow is dezelfde als bij microchess: `state`, code wisselen op de server via `POST /oauth/token`, daarna `GET /api/me`, verlengen via `POST /api/session/extend`, en afmelden via `POST /api/logout`. Het bearer-token van het account blijft in de PHP-sessie en komt niet in JavaScript.
46De OAuth-flow is dezelfde als bij microchess: `state`, code wisselen op de server via `POST /oauth/token`, daarna `GET /api/me`, verlengen via `POST /api/session/extend`, en afmelden via `POST /api/logout`. Het bearer-token van het account blijft in de PHP-sessie en komt niet in JavaScript.
47
47
@@ -112,7 +112,7 @@ curl -sS -H 'Authorization: Bearer vb_JOUW_SLEUTEL' \
112
112
113Fouten zijn `{"error":"…"}`. Validatie die de drie-verhalenregel raakt geeft 422. De menselijke uitleg met dezelfde voorbeelden staat op `docs.php`.
113Fouten zijn `{"error":"…"}`. Validatie die de drie-verhalenregel raakt geeft 422. De menselijke uitleg met dezelfde voorbeelden staat op `docs.php`.
114
114
115Een 401 (geen header, verkeerd formaat, of een onbekende/ingetrokken sleutel) zet `WWW-Authenticate: Bearer` en voegt `how_to_authenticate` toe, met dezelfde tekst in `hint`. Die tekst noemt het geval, de header `Authorization: Bearer vb_…`, Sleutels op `{base_url}/#/sleutels`, en een link naar `docs.php`. Een 403 omdat een lezer iets doet dat een sleutel of beheerder vereist, heeft die uitleg ook, zonder `WWW-Authenticate`. Sleutels zelf beheren kan alleen in de beheerderssessie. Een 403 door een ongeldige CSRF-header blijft alleen `{"error":"…"}`.
115Een 401 (geen header, verkeerd formaat, of een onbekende/ingetrokken sleutel) zet `WWW-Authenticate: Bearer` en voegt `how_to_authenticate` toe, met dezelfde tekst in `hint`. Die tekst noemt het geval, de header `Authorization: Bearer vb_…`, Beheer op `{base_url}/#/beheer`, en een link naar `docs.php`. Een 403 omdat een lezer iets doet dat een sleutel of beheerder vereist, heeft die uitleg ook, zonder `WWW-Authenticate`. Sleutels zelf beheren kan alleen in de beheerderssessie, onderaan Beheer. Een 403 door een ongeldige CSRF-header blijft alleen `{"error":"…"}`.
116
116
117```sh
117```sh
118curl -sS -D - -o - \
118curl -sS -D - -o - \
web/assets/app.css +31 −1
@@ -281,6 +281,13 @@ button:disabled, .continue:disabled { opacity: 0.55; cursor: default; }
281 281 gap: 0.9rem;
282 282 margin: 0.4rem 0 3rem;
283 283 }
284 .panel .keys {
285 margin: 0.6rem 0 0;
286 padding-top: 0.2rem;
287 border-top: 1px solid var(--line);
288 scroll-margin-top: 0.75rem;
289 }
290 .panel .keys h3 { margin: 0.2rem 0 0; }
284 291 label { display: grid; gap: 0.3rem; font-size: 0.95rem; }
285 292 input, textarea {
286 293 width: 100%;
@@ -405,7 +412,30 @@ legend { padding: 0 0.3rem; color: var(--muted); }
405 412 }
406 413 .wiki-chapter h2 { font-size: 1.35rem; margin: 0.15rem 0 0.7rem; }
407 414 .wiki-chapter p { font-size: 1.15rem; line-height: 1.75; margin: 0 0 1rem; }
408 .wiki-link { color: var(--accent); }
415 .wiki-chapter ul, .wiki-chapter ol {
416 margin: 0 0 1rem;
417 padding-left: 1.25rem;
418 line-height: 1.75;
419 }
420 .wiki-chapter li { margin: 0.15rem 0; }
421 .wiki-chapter li > p { margin: 0.15rem 0; }
422 .wiki-chapter li > ul, .wiki-chapter li > ol { margin: 0.15rem 0 0.35rem; }
423 .wiki-chapter blockquote {
424 margin: 0 0 1rem;
425 padding: 0.05rem 0 0.05rem 0.9rem;
426 border-left: 3px solid var(--line);
427 }
428 .wiki-chapter blockquote > :last-child { margin-bottom: 0; }
429 .wiki-chapter code {
430 font-family: ui-monospace, "Cascadia Mono", "Liberation Mono", monospace;
431 font-size: 0.88em;
432 background: var(--bg-raised);
433 padding: 0.05rem 0.3rem;
434 border: 1px solid var(--line);
435 border-radius: 0.35rem;
436 overflow-wrap: anywhere;
437 }
438 .wiki-link, .wiki-url { color: var(--accent); }
409 439 .wiki-broken { color: var(--muted); border-bottom: 1px dashed var(--muted); }
410 440 .wiki-missing {
411 441 font-size: 0.72em;
@@ -281,6 +281,13 @@ button:disabled, .continue:disabled { opacity: 0.55; cursor: default; }
281 gap: 0.9rem;
281 gap: 0.9rem;
282 margin: 0.4rem 0 3rem;
282 margin: 0.4rem 0 3rem;
283}
283}
284.panel .keys {
285 margin: 0.6rem 0 0;
286 padding-top: 0.2rem;
287 border-top: 1px solid var(--line);
288 scroll-margin-top: 0.75rem;
289}
290.panel .keys h3 { margin: 0.2rem 0 0; }
284label { display: grid; gap: 0.3rem; font-size: 0.95rem; }
291label { display: grid; gap: 0.3rem; font-size: 0.95rem; }
285input, textarea {
292input, textarea {
286 width: 100%;
293 width: 100%;
@@ -405,7 +412,30 @@ legend { padding: 0 0.3rem; color: var(--muted); }
405}
412}
406.wiki-chapter h2 { font-size: 1.35rem; margin: 0.15rem 0 0.7rem; }
413.wiki-chapter h2 { font-size: 1.35rem; margin: 0.15rem 0 0.7rem; }
407.wiki-chapter p { font-size: 1.15rem; line-height: 1.75; margin: 0 0 1rem; }
414.wiki-chapter p { font-size: 1.15rem; line-height: 1.75; margin: 0 0 1rem; }
408.wiki-link { color: var(--accent); }
415.wiki-chapter ul, .wiki-chapter ol {
416 margin: 0 0 1rem;
417 padding-left: 1.25rem;
418 line-height: 1.75;
419}
420.wiki-chapter li { margin: 0.15rem 0; }
421.wiki-chapter li > p { margin: 0.15rem 0; }
422.wiki-chapter li > ul, .wiki-chapter li > ol { margin: 0.15rem 0 0.35rem; }
423.wiki-chapter blockquote {
424 margin: 0 0 1rem;
425 padding: 0.05rem 0 0.05rem 0.9rem;
426 border-left: 3px solid var(--line);
427}
428.wiki-chapter blockquote > :last-child { margin-bottom: 0; }
429.wiki-chapter code {
430 font-family: ui-monospace, "Cascadia Mono", "Liberation Mono", monospace;
431 font-size: 0.88em;
432 background: var(--bg-raised);
433 padding: 0.05rem 0.3rem;
434 border: 1px solid var(--line);
435 border-radius: 0.35rem;
436 overflow-wrap: anywhere;
437}
438.wiki-link, .wiki-url { color: var(--accent); }
409.wiki-broken { color: var(--muted); border-bottom: 1px dashed var(--muted); }
439.wiki-broken { color: var(--muted); border-bottom: 1px dashed var(--muted); }
410.wiki-missing {
440.wiki-missing {
411 font-size: 0.72em;
441 font-size: 0.72em;
web/assets/app.js +108 −22
@@ -2,7 +2,7 @@
2 2
3 3 const MONTHS = ['januari', 'februari', 'maart', 'april', 'mei', 'juni', 'juli', 'augustus', 'september', 'oktober', 'november', 'december'];
4 4 const ROMAN = ['I', 'II', 'III'];
5 const state = { me: null, csrf: '', local: false, freshKey: null, revealedKey: null, wikiQuery: '', showWiki: false };
5 const state = { me: null, csrf: '', local: false, freshKey: null, revealedKey: null, wikiQuery: '', showWiki: false, focusKeys: false };
6 6 let renderToken = 0;
7 7 let menuAnchor = null;
8 8 let ignoreCloseUntil = 0;
@@ -578,7 +578,7 @@ async function paintEditor(date) {
578 578 }
579 579
580 580 async function paintBeheer() {
581 const [days, people] = await Promise.all([api('GET', '/days'), api('GET', '/users')]);
581 const [days, people, keyData] = await Promise.all([api('GET', '/days'), api('GET', '/users'), api('GET', '/keys')]);
582 582 const users = el('div', { class: 'user-list' });
583 583 people.users.forEach((person) => {
584 584 const self = person.id === state.me.id;
@@ -626,7 +626,13 @@ async function paintBeheer() {
626 626 el('h2', {}, ['Dagen']),
627 627 el('a', { class: 'button primary', href: '#/beheer/nieuw' }, ['Nieuwe dag']),
628 628 list,
629 paintKeys(keyData.keys),
629 630 ]));
631 if (state.focusKeys) {
632 state.focusKeys = false;
633 const node = document.getElementById('api-sleutels');
634 if (node) node.scrollIntoView({ block: 'start' });
635 }
630 636 }
631 637
632 638 function tokenPanel(title, token) {
@@ -659,7 +665,7 @@ function paintKeys(keys) {
659 665 await render();
660 666 } catch (failure) { error.textContent = failure.message; }
661 667 });
662 const section = el('section', { class: 'keys' }, [el('h1', {}, ['API-sleutels']), form]);
668 const section = el('section', { class: 'keys', id: 'api-sleutels' }, [el('h2', {}, ['API-sleutels']), form]);
663 669 if (state.revealedKey && state.revealedKey.token) {
664 670 section.append(tokenPanel('Sleutel van ' + state.revealedKey.name, state.revealedKey.token));
665 671 } else if (state.freshKey && state.freshKey.token) {
@@ -690,41 +696,117 @@ function paintKeys(keys) {
690 696 list.append(el('div', { class: 'key-row' }, [open, revoke]));
691 697 });
692 698 if (!keys.length) list.append(el('p', { class: 'empty' }, ['Nog geen sleutels.']));
693 section.append(el('h2', {}, ['Bestaande sleutels']), el('p', { class: 'lede' }, ['Tik op een sleutel om de volledige sleutel opnieuw te zien.']), list);
694 app.replaceChildren(section);
699 section.append(el('h3', {}, ['Bestaande sleutels']), el('p', { class: 'lede' }, ['Tik op een sleutel om de volledige sleutel opnieuw te zien.']), list);
700 return section;
695 701 }
696 702
697 703 function wikiSlugOk(value) {
698 704 return typeof value === 'string' && /^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(value);
699 705 }
700 706
701 function appendWikiInline(parent, part) {
707 function wikiExternalHref(value) {
708 if (typeof value !== 'string' || value.length === 0 || value.length > 2000) return null;
709 if (/[\u0000-\u0020\u007F<>"'\\]/.test(value)) return null;
710 if (!/^(https?:\/\/|mailto:)/i.test(value)) return null;
711 if (/^mailto:/i.test(value) && !/^mailto:[^@\s]+@[^@\s]+/i.test(value)) return null;
712 try {
713 const parsed = new URL(value);
714 const protocol = parsed.protocol.toLowerCase();
715 if (protocol !== 'http:' && protocol !== 'https:' && protocol !== 'mailto:') return null;
716 } catch (error) {
717 return null;
718 }
719 return value;
720 }
721
722 function appendWikiInlines(parent, parts, inAnchor) {
723 (parts || []).forEach((part) => appendWikiInline(parent, part, inAnchor));
724 }
725
726 function appendWikiInline(parent, part, inAnchor) {
702 727 if (!part || typeof part !== 'object') return;
703 if (part.type === 'link' && part.broken === false && wikiSlugOk(part.page) && (part.anchor == null || wikiSlugOk(part.anchor))) {
728 if (part.type === 'strong' || part.type === 'em') {
729 const node = el(part.type === 'strong' ? 'strong' : 'em', {});
730 appendWikiInlines(node, part.inlines, inAnchor);
731 parent.append(node);
732 return;
733 }
734 if (part.type === 'code') {
735 parent.append(el('code', {}, [typeof part.text === 'string' ? part.text : '']));
736 return;
737 }
738 if (part.type === 'break') {
739 parent.append(document.createElement('br'));
740 return;
741 }
742 if (part.type === 'url') {
743 const href = !inAnchor ? wikiExternalHref(part.href) : null;
744 if (href) {
745 const attrs = { href, rel: 'noopener noreferrer', class: 'wiki-url' };
746 if (/^https?:/i.test(href)) attrs.target = '_blank';
747 const link = el('a', attrs);
748 appendWikiInlines(link, part.inlines, true);
749 if (!link.childNodes.length) link.append(document.createTextNode(href));
750 parent.append(link);
751 return;
752 }
753 appendWikiInlines(parent, part.inlines, inAnchor);
754 return;
755 }
756 if (part.type === 'link' && !inAnchor && part.broken === false && wikiSlugOk(part.page) && (part.anchor == null || wikiSlugOk(part.anchor))) {
704 757 const href = part.anchor ? '#/wiki/' + part.page + '/' + part.anchor : '#/wiki/' + part.page;
705 758 parent.append(el('a', { href, class: 'wiki-link' }, [part.text || part.page]));
706 759 return;
707 760 }
708 if (part.type === 'link') {
761 if (part.type === 'link' && !inAnchor) {
709 762 const mark = el('span', { class: 'wiki-broken' }, [part.text || '']);
710 763 mark.append(el('span', { class: 'wiki-missing' }, ['ontbreekt']));
711 764 parent.append(mark);
712 765 return;
713 766 }
767 if (part.type === 'link') {
768 parent.append(document.createTextNode(typeof part.text === 'string' ? part.text : ''));
769 return;
770 }
714 771 parent.append(document.createTextNode(typeof part.text === 'string' ? part.text : ''));
715 772 }
716 773
774 function appendWikiBlocks(parent, blocks) {
775 (blocks || []).forEach((block) => parent.append(wikiBlockNode(block)));
776 }
777
778 function wikiBlockNode(block) {
779 if (!block || typeof block !== 'object') return el('p', {});
780 if (block.type === 'list') {
781 const ordered = block.ordered === true;
782 const list = el(ordered ? 'ol' : 'ul', {});
783 if (ordered && Number.isInteger(block.start) && block.start > 1 && block.start < 1000000000) {
784 list.setAttribute('start', String(block.start));
785 }
786 (block.items || []).forEach((item) => {
787 const li = el('li', {});
788 appendWikiBlocks(li, item && item.blocks);
789 list.append(li);
790 });
791 return list;
792 }
793 if (block.type === 'quote') {
794 const quote = el('blockquote', {});
795 appendWikiBlocks(quote, block.blocks);
796 return quote;
797 }
798 const paragraph = el('p', {});
799 appendWikiInlines(paragraph, block.inlines, false);
800 return paragraph;
801 }
802
717 803 function wikiChapterNode(chapter, currentAnchor) {
718 804 const section = el('section', {
719 805 class: 'wiki-chapter' + (chapter.anchor === currentAnchor ? ' is-target' : ''),
720 806 id: 'wiki-' + chapter.anchor,
721 807 });
722 808 if (chapter.title) section.append(el('h2', {}, [chapter.title]));
723 (chapter.blocks || []).forEach((block) => {
724 const paragraph = el('p', {});
725 (block.inlines || []).forEach((part) => appendWikiInline(paragraph, part));
726 section.append(paragraph);
727 });
809 appendWikiBlocks(section, chapter.blocks);
728 810 if (!chapter.title && !(chapter.blocks || []).length) section.append(el('p', {}, ['']));
729 811 return section;
730 812 }
@@ -902,7 +984,7 @@ async function paintWikiPageForm(slug, presetCategory) {
902 984 el('label', {}, ['Slug', slugInput]),
903 985 el('label', {}, ['Tekst', content]),
904 986 el('p', { class: 'hint' }, [
905 'Een hoofdstuk begint met ## en een titel op een eigen regel. Verwijzingen: [[pagina-slug]], [[#hoofdstuk]] en [[pagina-slug#hoofdstuk|tekst]]. Een kapotte verwijzing blijft zichtbaar en is geen link.',
987 'Een hoofdstuk begint met ## en een titel op een eigen regel. Verwijzingen: [[pagina-slug]], [[#hoofdstuk]] en [[pagina-slug#hoofdstuk|tekst]]. Ook lijsten (- en 1.), **vet**, *cursief*, `code` en [tekst](url). Een kapotte verwijzing blijft zichtbaar en is geen link.',
906 988 ]),
907 989 error,
908 990 el('button', { class: 'primary', type: 'submit' }, ['Opslaan']),
@@ -949,7 +1031,7 @@ async function render() {
949 1031 const path = pathNow();
950 1032 const traversal = historyTraversal;
951 1033 historyTraversal = false;
952 if (path !== '/sleutels') {
1034 if (path !== '/beheer') {
953 1035 state.freshKey = null;
954 1036 state.revealedKey = null;
955 1037 }
@@ -1000,8 +1082,17 @@ async function render() {
1000 1082 paintWikiArticle(page, reading.anchor);
1001 1083 } else if (path === '/instellingen') {
1002 1084 paintSettings();
1003 } else if (path === '/beheer') {
1004 if (!state.me.admin) { app.replaceChildren(el('p', { class: 'form-error' }, ['Alleen een beheerder mag dit.'])); return; }
1085 } else if (path === '/beheer' || path === '/sleutels') {
1086 if (path === '/sleutels') {
1087 state.focusKeys = true;
1088 history.replaceState(history.state, '', '#/beheer');
1089 highlight('/beheer');
1090 }
1091 if (!state.me.admin) {
1092 state.focusKeys = false;
1093 app.replaceChildren(el('p', { class: 'form-error' }, ['Alleen een beheerder mag dit.']));
1094 return;
1095 }
1005 1096 await paintBeheer();
1006 1097 } else if (path === '/beheer/nieuw') {
1007 1098 if (!state.me.admin) { app.replaceChildren(el('p', { class: 'form-error' }, ['Alleen een beheerder mag dit.'])); return; }
@@ -1009,11 +1100,6 @@ async function render() {
1009 1100 } else if (/^\/beheer\/\d{4}-\d{2}-\d{2}$/.test(path)) {
1010 1101 if (!state.me.admin) { app.replaceChildren(el('p', { class: 'form-error' }, ['Alleen een beheerder mag dit.'])); return; }
1011 1102 await paintEditor(path.slice('/beheer/'.length));
1012 } else if (path === '/sleutels') {
1013 if (!state.me.admin) { app.replaceChildren(el('p', { class: 'form-error' }, ['Alleen een beheerder mag dit.'])); return; }
1014 const data = await api('GET', '/keys');
1015 if (token !== renderToken) return;
1016 paintKeys(data.keys);
1017 1103 } else if (isDayRoute(path)) {
1018 1104 const date = path.slice(5);
1019 1105 const day = await api('GET', '/days/' + date);
@@ -2,7 +2,7 @@
2
2
3const MONTHS = ['januari', 'februari', 'maart', 'april', 'mei', 'juni', 'juli', 'augustus', 'september', 'oktober', 'november', 'december'];
3const MONTHS = ['januari', 'februari', 'maart', 'april', 'mei', 'juni', 'juli', 'augustus', 'september', 'oktober', 'november', 'december'];
4const ROMAN = ['I', 'II', 'III'];
4const ROMAN = ['I', 'II', 'III'];
5const state = { me: null, csrf: '', local: false, freshKey: null, revealedKey: null, wikiQuery: '', showWiki: false };
5const state = { me: null, csrf: '', local: false, freshKey: null, revealedKey: null, wikiQuery: '', showWiki: false, focusKeys: false };
6let renderToken = 0;
6let renderToken = 0;
7let menuAnchor = null;
7let menuAnchor = null;
8let ignoreCloseUntil = 0;
8let ignoreCloseUntil = 0;
@@ -578,7 +578,7 @@ async function paintEditor(date) {
578}
578}
579
579
580async function paintBeheer() {
580async function paintBeheer() {
581 const [days, people] = await Promise.all([api('GET', '/days'), api('GET', '/users')]);
581 const [days, people, keyData] = await Promise.all([api('GET', '/days'), api('GET', '/users'), api('GET', '/keys')]);
582 const users = el('div', { class: 'user-list' });
582 const users = el('div', { class: 'user-list' });
583 people.users.forEach((person) => {
583 people.users.forEach((person) => {
584 const self = person.id === state.me.id;
584 const self = person.id === state.me.id;
@@ -626,7 +626,13 @@ async function paintBeheer() {
626 el('h2', {}, ['Dagen']),
626 el('h2', {}, ['Dagen']),
627 el('a', { class: 'button primary', href: '#/beheer/nieuw' }, ['Nieuwe dag']),
627 el('a', { class: 'button primary', href: '#/beheer/nieuw' }, ['Nieuwe dag']),
628 list,
628 list,
629 paintKeys(keyData.keys),
629 ]));
630 ]));
631 if (state.focusKeys) {
632 state.focusKeys = false;
633 const node = document.getElementById('api-sleutels');
634 if (node) node.scrollIntoView({ block: 'start' });
635 }
630}
636}
631
637
632function tokenPanel(title, token) {
638function tokenPanel(title, token) {
@@ -659,7 +665,7 @@ function paintKeys(keys) {
659 await render();
665 await render();
660 } catch (failure) { error.textContent = failure.message; }
666 } catch (failure) { error.textContent = failure.message; }
661 });
667 });
662 const section = el('section', { class: 'keys' }, [el('h1', {}, ['API-sleutels']), form]);
668 const section = el('section', { class: 'keys', id: 'api-sleutels' }, [el('h2', {}, ['API-sleutels']), form]);
663 if (state.revealedKey && state.revealedKey.token) {
669 if (state.revealedKey && state.revealedKey.token) {
664 section.append(tokenPanel('Sleutel van ' + state.revealedKey.name, state.revealedKey.token));
670 section.append(tokenPanel('Sleutel van ' + state.revealedKey.name, state.revealedKey.token));
665 } else if (state.freshKey && state.freshKey.token) {
671 } else if (state.freshKey && state.freshKey.token) {
@@ -690,41 +696,117 @@ function paintKeys(keys) {
690 list.append(el('div', { class: 'key-row' }, [open, revoke]));
696 list.append(el('div', { class: 'key-row' }, [open, revoke]));
691 });
697 });
692 if (!keys.length) list.append(el('p', { class: 'empty' }, ['Nog geen sleutels.']));
698 if (!keys.length) list.append(el('p', { class: 'empty' }, ['Nog geen sleutels.']));
693 section.append(el('h2', {}, ['Bestaande sleutels']), el('p', { class: 'lede' }, ['Tik op een sleutel om de volledige sleutel opnieuw te zien.']), list);
699 section.append(el('h3', {}, ['Bestaande sleutels']), el('p', { class: 'lede' }, ['Tik op een sleutel om de volledige sleutel opnieuw te zien.']), list);
694 app.replaceChildren(section);
700 return section;
695}
701}
696
702
697function wikiSlugOk(value) {
703function wikiSlugOk(value) {
698 return typeof value === 'string' && /^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(value);
704 return typeof value === 'string' && /^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(value);
699}
705}
700
706
701function appendWikiInline(parent, part) {
707function wikiExternalHref(value) {
708 if (typeof value !== 'string' || value.length === 0 || value.length > 2000) return null;
709 if (/[\u0000-\u0020\u007F<>"'\\]/.test(value)) return null;
710 if (!/^(https?:\/\/|mailto:)/i.test(value)) return null;
711 if (/^mailto:/i.test(value) && !/^mailto:[^@\s]+@[^@\s]+/i.test(value)) return null;
712 try {
713 const parsed = new URL(value);
714 const protocol = parsed.protocol.toLowerCase();
715 if (protocol !== 'http:' && protocol !== 'https:' && protocol !== 'mailto:') return null;
716 } catch (error) {
717 return null;
718 }
719 return value;
720}
721
722function appendWikiInlines(parent, parts, inAnchor) {
723 (parts || []).forEach((part) => appendWikiInline(parent, part, inAnchor));
724}
725
726function appendWikiInline(parent, part, inAnchor) {
702 if (!part || typeof part !== 'object') return;
727 if (!part || typeof part !== 'object') return;
703 if (part.type === 'link' && part.broken === false && wikiSlugOk(part.page) && (part.anchor == null || wikiSlugOk(part.anchor))) {
728 if (part.type === 'strong' || part.type === 'em') {
729 const node = el(part.type === 'strong' ? 'strong' : 'em', {});
730 appendWikiInlines(node, part.inlines, inAnchor);
731 parent.append(node);
732 return;
733 }
734 if (part.type === 'code') {
735 parent.append(el('code', {}, [typeof part.text === 'string' ? part.text : '']));
736 return;
737 }
738 if (part.type === 'break') {
739 parent.append(document.createElement('br'));
740 return;
741 }
742 if (part.type === 'url') {
743 const href = !inAnchor ? wikiExternalHref(part.href) : null;
744 if (href) {
745 const attrs = { href, rel: 'noopener noreferrer', class: 'wiki-url' };
746 if (/^https?:/i.test(href)) attrs.target = '_blank';
747 const link = el('a', attrs);
748 appendWikiInlines(link, part.inlines, true);
749 if (!link.childNodes.length) link.append(document.createTextNode(href));
750 parent.append(link);
751 return;
752 }
753 appendWikiInlines(parent, part.inlines, inAnchor);
754 return;
755 }
756 if (part.type === 'link' && !inAnchor && part.broken === false && wikiSlugOk(part.page) && (part.anchor == null || wikiSlugOk(part.anchor))) {
704 const href = part.anchor ? '#/wiki/' + part.page + '/' + part.anchor : '#/wiki/' + part.page;
757 const href = part.anchor ? '#/wiki/' + part.page + '/' + part.anchor : '#/wiki/' + part.page;
705 parent.append(el('a', { href, class: 'wiki-link' }, [part.text || part.page]));
758 parent.append(el('a', { href, class: 'wiki-link' }, [part.text || part.page]));
706 return;
759 return;
707 }
760 }
708 if (part.type === 'link') {
761 if (part.type === 'link' && !inAnchor) {
709 const mark = el('span', { class: 'wiki-broken' }, [part.text || '']);
762 const mark = el('span', { class: 'wiki-broken' }, [part.text || '']);
710 mark.append(el('span', { class: 'wiki-missing' }, ['ontbreekt']));
763 mark.append(el('span', { class: 'wiki-missing' }, ['ontbreekt']));
711 parent.append(mark);
764 parent.append(mark);
712 return;
765 return;
713 }
766 }
767 if (part.type === 'link') {
768 parent.append(document.createTextNode(typeof part.text === 'string' ? part.text : ''));
769 return;
770 }
714 parent.append(document.createTextNode(typeof part.text === 'string' ? part.text : ''));
771 parent.append(document.createTextNode(typeof part.text === 'string' ? part.text : ''));
715}
772}
716
773
774function appendWikiBlocks(parent, blocks) {
775 (blocks || []).forEach((block) => parent.append(wikiBlockNode(block)));
776}
777
778function wikiBlockNode(block) {
779 if (!block || typeof block !== 'object') return el('p', {});
780 if (block.type === 'list') {
781 const ordered = block.ordered === true;
782 const list = el(ordered ? 'ol' : 'ul', {});
783 if (ordered && Number.isInteger(block.start) && block.start > 1 && block.start < 1000000000) {
784 list.setAttribute('start', String(block.start));
785 }
786 (block.items || []).forEach((item) => {
787 const li = el('li', {});
788 appendWikiBlocks(li, item && item.blocks);
789 list.append(li);
790 });
791 return list;
792 }
793 if (block.type === 'quote') {
794 const quote = el('blockquote', {});
795 appendWikiBlocks(quote, block.blocks);
796 return quote;
797 }
798 const paragraph = el('p', {});
799 appendWikiInlines(paragraph, block.inlines, false);
800 return paragraph;
801}
802
717function wikiChapterNode(chapter, currentAnchor) {
803function wikiChapterNode(chapter, currentAnchor) {
718 const section = el('section', {
804 const section = el('section', {
719 class: 'wiki-chapter' + (chapter.anchor === currentAnchor ? ' is-target' : ''),
805 class: 'wiki-chapter' + (chapter.anchor === currentAnchor ? ' is-target' : ''),
720 id: 'wiki-' + chapter.anchor,
806 id: 'wiki-' + chapter.anchor,
721 });
807 });
722 if (chapter.title) section.append(el('h2', {}, [chapter.title]));
808 if (chapter.title) section.append(el('h2', {}, [chapter.title]));
723 (chapter.blocks || []).forEach((block) => {
809 appendWikiBlocks(section, chapter.blocks);
724 const paragraph = el('p', {});
725 (block.inlines || []).forEach((part) => appendWikiInline(paragraph, part));
726 section.append(paragraph);
727 });
728 if (!chapter.title && !(chapter.blocks || []).length) section.append(el('p', {}, ['']));
810 if (!chapter.title && !(chapter.blocks || []).length) section.append(el('p', {}, ['']));
729 return section;
811 return section;
730}
812}
@@ -902,7 +984,7 @@ async function paintWikiPageForm(slug, presetCategory) {
902 el('label', {}, ['Slug', slugInput]),
984 el('label', {}, ['Slug', slugInput]),
903 el('label', {}, ['Tekst', content]),
985 el('label', {}, ['Tekst', content]),
904 el('p', { class: 'hint' }, [
986 el('p', { class: 'hint' }, [
905 'Een hoofdstuk begint met ## en een titel op een eigen regel. Verwijzingen: [[pagina-slug]], [[#hoofdstuk]] en [[pagina-slug#hoofdstuk|tekst]]. Een kapotte verwijzing blijft zichtbaar en is geen link.',
987 'Een hoofdstuk begint met ## en een titel op een eigen regel. Verwijzingen: [[pagina-slug]], [[#hoofdstuk]] en [[pagina-slug#hoofdstuk|tekst]]. Ook lijsten (- en 1.), **vet**, *cursief*, `code` en [tekst](url). Een kapotte verwijzing blijft zichtbaar en is geen link.',
906 ]),
988 ]),
907 error,
989 error,
908 el('button', { class: 'primary', type: 'submit' }, ['Opslaan']),
990 el('button', { class: 'primary', type: 'submit' }, ['Opslaan']),
@@ -949,7 +1031,7 @@ async function render() {
949 const path = pathNow();
1031 const path = pathNow();
950 const traversal = historyTraversal;
1032 const traversal = historyTraversal;
951 historyTraversal = false;
1033 historyTraversal = false;
952 if (path !== '/sleutels') {
1034 if (path !== '/beheer') {
953 state.freshKey = null;
1035 state.freshKey = null;
954 state.revealedKey = null;
1036 state.revealedKey = null;
955 }
1037 }
@@ -1000,8 +1082,17 @@ async function render() {
1000 paintWikiArticle(page, reading.anchor);
1082 paintWikiArticle(page, reading.anchor);
1001 } else if (path === '/instellingen') {
1083 } else if (path === '/instellingen') {
1002 paintSettings();
1084 paintSettings();
1003 } else if (path === '/beheer') {
1085 } else if (path === '/beheer' || path === '/sleutels') {
1004 if (!state.me.admin) { app.replaceChildren(el('p', { class: 'form-error' }, ['Alleen een beheerder mag dit.'])); return; }
1086 if (path === '/sleutels') {
1087 state.focusKeys = true;
1088 history.replaceState(history.state, '', '#/beheer');
1089 highlight('/beheer');
1090 }
1091 if (!state.me.admin) {
1092 state.focusKeys = false;
1093 app.replaceChildren(el('p', { class: 'form-error' }, ['Alleen een beheerder mag dit.']));
1094 return;
1095 }
1005 await paintBeheer();
1096 await paintBeheer();
1006 } else if (path === '/beheer/nieuw') {
1097 } else if (path === '/beheer/nieuw') {
1007 if (!state.me.admin) { app.replaceChildren(el('p', { class: 'form-error' }, ['Alleen een beheerder mag dit.'])); return; }
1098 if (!state.me.admin) { app.replaceChildren(el('p', { class: 'form-error' }, ['Alleen een beheerder mag dit.'])); return; }
@@ -1009,11 +1100,6 @@ async function render() {
1009 } else if (/^\/beheer\/\d{4}-\d{2}-\d{2}$/.test(path)) {
1100 } else if (/^\/beheer\/\d{4}-\d{2}-\d{2}$/.test(path)) {
1010 if (!state.me.admin) { app.replaceChildren(el('p', { class: 'form-error' }, ['Alleen een beheerder mag dit.'])); return; }
1101 if (!state.me.admin) { app.replaceChildren(el('p', { class: 'form-error' }, ['Alleen een beheerder mag dit.'])); return; }
1011 await paintEditor(path.slice('/beheer/'.length));
1102 await paintEditor(path.slice('/beheer/'.length));
1012 } else if (path === '/sleutels') {
1013 if (!state.me.admin) { app.replaceChildren(el('p', { class: 'form-error' }, ['Alleen een beheerder mag dit.'])); return; }
1014 const data = await api('GET', '/keys');
1015 if (token !== renderToken) return;
1016 paintKeys(data.keys);
1017 } else if (isDayRoute(path)) {
1103 } else if (isDayRoute(path)) {
1018 const date = path.slice(5);
1104 const date = path.slice(5);
1019 const day = await api('GET', '/days/' + date);
1105 const day = await api('GET', '/days/' + date);
web/docs.php +21 −4
@@ -18,7 +18,7 @@ $base = 'https://projects.timfalken.com/verhaaltjesboek';
18 18 <p><a href="./">← Verhalenboek</a></p>
19 19 <h1>API</h1>
20 20 <p>JSON REST voor een schrijver-agent. Elke aanvraag gaat naar <code>api.php</code> gevolgd door het pad, bijvoorbeeld <code><?= htmlspecialchars($base, ENT_QUOTES) ?>/api.php/days</code>. Lokaal is het pad hetzelfde op de ontwikkelserver.</p>
21 <p>Authenticatie: <code>Authorization: Bearer vb_…</code>. Een beheerder maakt sleutels aan onder Sleutels (<code><?= htmlspecialchars($base, ENT_QUOTES) ?>/#/sleutels</code>) en kan een bestaande sleutel daar opnieuw tonen. Stuur <code>Accept: application/json</code> en, bij een body, <code>Content-Type: application/json</code>. Fouten zijn JSON met status 401, 403, 404, 405, 409 of 422.</p>
21 <p>Authenticatie: <code>Authorization: Bearer vb_…</code>. Een beheerder maakt sleutels aan onderaan Beheer (<code><?= htmlspecialchars($base, ENT_QUOTES) ?>/#/beheer</code>) en kan een bestaande sleutel daar opnieuw tonen. Stuur <code>Accept: application/json</code> en, bij een body, <code>Content-Type: application/json</code>. Fouten zijn JSON met status 401, 403, 404, 405, 409 of 422.</p>
22 22 <h2>Geen of ongeldige authenticatie</h2>
23 23 <p>Een 401 heeft de header <code>WWW-Authenticate: Bearer</code>. Een 401, en een 403 wanneer een lezer iets doet dat een sleutel of beheerder vereist, bevat naast <code>error</code> ook <code>how_to_authenticate</code> en dezelfde tekst in <code>hint</code>. Die tekst onderscheidt drie gevallen en verwijst naar deze pagina:</p>
24 24 <ul>
@@ -29,7 +29,7 @@ $base = 'https://projects.timfalken.com/verhaaltjesboek';
29 29 <p>Voorbeeld bij een ontbrekende header:</p>
30 30 <pre><code>{
31 31 "error": "Log in om verder te gaan.",
32 "how_to_authenticate": "Er is geen Authorization-header. Stuur de header Authorization: Bearer vb_… met een API-sleutel. Een beheerder maakt sleutels aan onder Sleutels op <?= htmlspecialchars($base, ENT_QUOTES) ?>/#/sleutels. Uitleg: <?= htmlspecialchars($base, ENT_QUOTES) ?>/docs.php",
32 "how_to_authenticate": "Er is geen Authorization-header. Stuur de header Authorization: Bearer vb_… met een API-sleutel. Een beheerder maakt sleutels aan onder Beheer op <?= htmlspecialchars($base, ENT_QUOTES) ?>/#/beheer. Uitleg: <?= htmlspecialchars($base, ENT_QUOTES) ?>/docs.php",
33 33 "hint": "…"
34 34 }</code></pre>
35 35 <p><code>hint</code> is dezelfde tekst als <code>how_to_authenticate</code>. Een 403 voor een lezer die wil schrijven legt uit dat een API-sleutel of een beheerder nodig is. Sleutels beheren kan alleen in de ingelogde beheerderssessie, niet met de sleutel zelf. Een 403 door een ongeldige sessiecookie (CSRF) heeft deze uitleg niet.</p>
@@ -99,7 +99,23 @@ curl -sS -H 'Authorization: Bearer vb_JOUW_SLEUTEL' \
99 99 <p>Een slug is klein, met letters, cijfers en streepjes, bijvoorbeeld <code>oude-plein</code>. Ontbreekt hij, dan maakt de server hem uit de titel. <code>nieuw</code>, <code>bewerken</code> en <code>categorie</code> zijn gereserveerd voor pagina's; <code>nieuw</code> ook voor categorieën. Een bezette slug geeft 409. Een onbekende slug geeft 404. Een lege titel, een te lange tekst of een hoofdstuk zonder titel geeft 422.</p>
100 100 <h3>Hoofdstukken en ankers</h3>
101 101 <p>Het anker is de slug van de hoofdstuktitel, stabiel zolang de titel en de volgorde van gelijke titels hetzelfde blijven. <code>## De boom</code> wordt <code>de-boom</code>. Een tweede hoofdstuk met dezelfde titel wordt <code>de-boom-2</code>, daarna <code>de-boom-3</code>. De inleiding, als die er is, heeft altijd het anker <code>inleiding</code>. In het antwoord is <code>title</code> daar <code>null</code>.</p>
102 <p>Alinea's scheid je met een lege regel. Een regeleinde binnen een alinea wordt een spatie. HTML wordt niet gelezen: wat je typt blijft tekst.</p>
102 <p>Alinea's scheid je met een lege regel. Een regeleinde binnen een alinea wordt een spatie, zodat een zin die je over twee regels breekt één zin blijft. Twee spaties aan het eind van een regel, of een backslash, maken wel een zichtbaar regeleinde. HTML wordt niet gelezen: wat je typt blijft tekst, ook als het op een tag lijkt.</p>
103 <h3>Opmaak</h3>
104 <p>In de tekst van een hoofdstuk mag Markdown staan. Een regel die met <code>##</code> begint blijft een hoofdstuk en wordt geen gewone kop. <code>#</code> of <code>###</code> zonder die betekenis blijft gewone tekst.</p>
105 <table>
106 <thead><tr><th>Schrijfwijze</th><th>Resultaat</th></tr></thead>
107 <tbody>
108 <tr><td><code>- punt</code> of <code>* punt</code></td><td>Ongeordende lijst. Het streepje of sterretje staat aan het begin van de regel, gevolgd door een spatie.</td></tr>
109 <tr><td><code>1. punt</code></td><td>Genummerde lijst. Het eerste nummer bepaalt waar de telling begint.</td></tr>
110 <tr><td>twee spaties extra</td><td>Een geneste lijst. Spring minstens twee spaties verder in dan de regel erboven. Een lege regel tussen punten mag.</td></tr>
111 <tr><td><code>**vet**</code> of <code>__vet__</code></td><td>Vet. <code>***beide***</code> is vet én cursief.</td></tr>
112 <tr><td><code>*cursief*</code> of <code>_cursief_</code></td><td>Cursief. Een underscore midden in een woord, zoals <code>foo_bar</code>, blijft tekst.</td></tr>
113 <tr><td><code>`code`</code></td><td>Code. Sterretjes en verwijzingen daarbinnen blijven letterlijk.</td></tr>
114 <tr><td><code>&gt; citaat</code></td><td>Citaat. Zet het teken aan het begin van elke regel van het citaat.</td></tr>
115 <tr><td><code>[tekst](https://…)</code></td><td>Externe link. Alleen <code>http</code>, <code>https</code> en <code>mailto</code> (met een <code>@</code>) worden een link, met <code>rel="noopener"</code>. <code>javascript:</code> en andere schema's blijven gewone tekst.</td></tr>
116 </tbody>
117 </table>
118 <p>Vet, cursief en code mogen door elkaar, in een lijstpunt en om een verwijzing heen. Een <code>[[verwijzing]]</code> in een lijstpunt of in vette tekst blijft een verwijzing. Een backslash voor een sterretje, hekje of haakje maakt dat teken letterlijk.</p>
103 119 <h3>Verwijzingen in de tekst</h3>
104 120 <p>In de tekst van een pagina schrijf je een verwijzing tussen dubbele rechte haken. Het doel is altijd een slug, geen titel. Een eigen zichtbare tekst zet je achter een staande streep. De streep en de tekst zijn optioneel.</p>
105 121 <table>
@@ -114,7 +130,8 @@ curl -sS -H 'Authorization: Bearer vb_JOUW_SLEUTEL' \
114 130 </tbody>
115 131 </table>
116 132 <p>Een verwijzing die nergens heen wijst — onbekende pagina, onbekend anker, of een slug die niet aan het patroon voldoet — blijft in de tekst staan en is geen link. In de JSON heeft zo'n stuk <code>"broken": true</code> en geen <code>page</code>. In de app staat er „ontbreekt” achter. Een stuk als <code>&lt;script&gt;</code> of <code>javascript:</code> wordt gewone tekst en wordt niet uitgevoerd.</p>
117 <p>In het antwoord bestaat een alinea uit <code>inlines</code>. Een tekststuk is <code>{"type":"text","text":"…"}</code>. Een verwijzing is <code>{"type":"link","page":"oude-plein","anchor":"de-boom","text":"de boom","broken":false}</code>. <code>anchor</code> is <code>null</code> als de verwijzing de hele pagina bedoelt.</p>
133 <p>In het antwoord heeft een blok een <code>type</code>. Een alinea is <code>{"type":"paragraph","inlines":[…]}</code>. Een lijst is <code>{"type":"list","ordered":false,"items":[{"blocks":[…]}]}</code>; bij een genummerde lijst is <code>ordered</code> <code>true</code> en staat <code>start</code> erbij als de telling niet bij 1 begint. Een citaat is <code>{"type":"quote","blocks":[…]}</code>. Geneste lijsten zitten in de <code>blocks</code> van een punt.</p>
134 <p>Een tekststuk is <code>{"type":"text","text":"…"}</code>. Een verwijzing is <code>{"type":"link","page":"oude-plein","anchor":"de-boom","text":"de boom","broken":false}</code>. <code>anchor</code> is <code>null</code> als de verwijzing de hele pagina bedoelt. Vet is <code>{"type":"strong","inlines":[…]}</code>, cursief <code>{"type":"em","inlines":[…]}</code>, code <code>{"type":"code","text":"…"}</code> en een zichtbaar regeleinde <code>{"type":"break"}</code>. Een externe link is <code>{"type":"url","href":"https://…","inlines":[…]}</code>. Een verwijzing in het label van zo'n link wordt daar gewone tekst, zodat er geen link in een link ontstaat.</p>
118 135 <h3>Voorbeeld</h3>
119 136 <pre><code>curl -sS -X POST \
120 137 -H 'Authorization: Bearer vb_JOUW_SLEUTEL' \
@@ -18,7 +18,7 @@ $base = 'https://projects.timfalken.com/verhaaltjesboek';
18<p><a href="./">← Verhalenboek</a></p>
18<p><a href="./">← Verhalenboek</a></p>
19<h1>API</h1>
19<h1>API</h1>
20<p>JSON REST voor een schrijver-agent. Elke aanvraag gaat naar <code>api.php</code> gevolgd door het pad, bijvoorbeeld <code><?= htmlspecialchars($base, ENT_QUOTES) ?>/api.php/days</code>. Lokaal is het pad hetzelfde op de ontwikkelserver.</p>
20<p>JSON REST voor een schrijver-agent. Elke aanvraag gaat naar <code>api.php</code> gevolgd door het pad, bijvoorbeeld <code><?= htmlspecialchars($base, ENT_QUOTES) ?>/api.php/days</code>. Lokaal is het pad hetzelfde op de ontwikkelserver.</p>
21<p>Authenticatie: <code>Authorization: Bearer vb_…</code>. Een beheerder maakt sleutels aan onder Sleutels (<code><?= htmlspecialchars($base, ENT_QUOTES) ?>/#/sleutels</code>) en kan een bestaande sleutel daar opnieuw tonen. Stuur <code>Accept: application/json</code> en, bij een body, <code>Content-Type: application/json</code>. Fouten zijn JSON met status 401, 403, 404, 405, 409 of 422.</p>
21<p>Authenticatie: <code>Authorization: Bearer vb_…</code>. Een beheerder maakt sleutels aan onderaan Beheer (<code><?= htmlspecialchars($base, ENT_QUOTES) ?>/#/beheer</code>) en kan een bestaande sleutel daar opnieuw tonen. Stuur <code>Accept: application/json</code> en, bij een body, <code>Content-Type: application/json</code>. Fouten zijn JSON met status 401, 403, 404, 405, 409 of 422.</p>
22<h2>Geen of ongeldige authenticatie</h2>
22<h2>Geen of ongeldige authenticatie</h2>
23<p>Een 401 heeft de header <code>WWW-Authenticate: Bearer</code>. Een 401, en een 403 wanneer een lezer iets doet dat een sleutel of beheerder vereist, bevat naast <code>error</code> ook <code>how_to_authenticate</code> en dezelfde tekst in <code>hint</code>. Die tekst onderscheidt drie gevallen en verwijst naar deze pagina:</p>
23<p>Een 401 heeft de header <code>WWW-Authenticate: Bearer</code>. Een 401, en een 403 wanneer een lezer iets doet dat een sleutel of beheerder vereist, bevat naast <code>error</code> ook <code>how_to_authenticate</code> en dezelfde tekst in <code>hint</code>. Die tekst onderscheidt drie gevallen en verwijst naar deze pagina:</p>
24<ul>
24<ul>
@@ -29,7 +29,7 @@ $base = 'https://projects.timfalken.com/verhaaltjesboek';
29<p>Voorbeeld bij een ontbrekende header:</p>
29<p>Voorbeeld bij een ontbrekende header:</p>
30<pre><code>{
30<pre><code>{
31 "error": "Log in om verder te gaan.",
31 "error": "Log in om verder te gaan.",
32 "how_to_authenticate": "Er is geen Authorization-header. Stuur de header Authorization: Bearer vb_… met een API-sleutel. Een beheerder maakt sleutels aan onder Sleutels op <?= htmlspecialchars($base, ENT_QUOTES) ?>/#/sleutels. Uitleg: <?= htmlspecialchars($base, ENT_QUOTES) ?>/docs.php",
32 "how_to_authenticate": "Er is geen Authorization-header. Stuur de header Authorization: Bearer vb_… met een API-sleutel. Een beheerder maakt sleutels aan onder Beheer op <?= htmlspecialchars($base, ENT_QUOTES) ?>/#/beheer. Uitleg: <?= htmlspecialchars($base, ENT_QUOTES) ?>/docs.php",
33 "hint": "…"
33 "hint": "…"
34}</code></pre>
34}</code></pre>
35<p><code>hint</code> is dezelfde tekst als <code>how_to_authenticate</code>. Een 403 voor een lezer die wil schrijven legt uit dat een API-sleutel of een beheerder nodig is. Sleutels beheren kan alleen in de ingelogde beheerderssessie, niet met de sleutel zelf. Een 403 door een ongeldige sessiecookie (CSRF) heeft deze uitleg niet.</p>
35<p><code>hint</code> is dezelfde tekst als <code>how_to_authenticate</code>. Een 403 voor een lezer die wil schrijven legt uit dat een API-sleutel of een beheerder nodig is. Sleutels beheren kan alleen in de ingelogde beheerderssessie, niet met de sleutel zelf. Een 403 door een ongeldige sessiecookie (CSRF) heeft deze uitleg niet.</p>
@@ -99,7 +99,23 @@ curl -sS -H 'Authorization: Bearer vb_JOUW_SLEUTEL' \
99<p>Een slug is klein, met letters, cijfers en streepjes, bijvoorbeeld <code>oude-plein</code>. Ontbreekt hij, dan maakt de server hem uit de titel. <code>nieuw</code>, <code>bewerken</code> en <code>categorie</code> zijn gereserveerd voor pagina's; <code>nieuw</code> ook voor categorieën. Een bezette slug geeft 409. Een onbekende slug geeft 404. Een lege titel, een te lange tekst of een hoofdstuk zonder titel geeft 422.</p>
99<p>Een slug is klein, met letters, cijfers en streepjes, bijvoorbeeld <code>oude-plein</code>. Ontbreekt hij, dan maakt de server hem uit de titel. <code>nieuw</code>, <code>bewerken</code> en <code>categorie</code> zijn gereserveerd voor pagina's; <code>nieuw</code> ook voor categorieën. Een bezette slug geeft 409. Een onbekende slug geeft 404. Een lege titel, een te lange tekst of een hoofdstuk zonder titel geeft 422.</p>
100<h3>Hoofdstukken en ankers</h3>
100<h3>Hoofdstukken en ankers</h3>
101<p>Het anker is de slug van de hoofdstuktitel, stabiel zolang de titel en de volgorde van gelijke titels hetzelfde blijven. <code>## De boom</code> wordt <code>de-boom</code>. Een tweede hoofdstuk met dezelfde titel wordt <code>de-boom-2</code>, daarna <code>de-boom-3</code>. De inleiding, als die er is, heeft altijd het anker <code>inleiding</code>. In het antwoord is <code>title</code> daar <code>null</code>.</p>
101<p>Het anker is de slug van de hoofdstuktitel, stabiel zolang de titel en de volgorde van gelijke titels hetzelfde blijven. <code>## De boom</code> wordt <code>de-boom</code>. Een tweede hoofdstuk met dezelfde titel wordt <code>de-boom-2</code>, daarna <code>de-boom-3</code>. De inleiding, als die er is, heeft altijd het anker <code>inleiding</code>. In het antwoord is <code>title</code> daar <code>null</code>.</p>
102<p>Alinea's scheid je met een lege regel. Een regeleinde binnen een alinea wordt een spatie. HTML wordt niet gelezen: wat je typt blijft tekst.</p>
102<p>Alinea's scheid je met een lege regel. Een regeleinde binnen een alinea wordt een spatie, zodat een zin die je over twee regels breekt één zin blijft. Twee spaties aan het eind van een regel, of een backslash, maken wel een zichtbaar regeleinde. HTML wordt niet gelezen: wat je typt blijft tekst, ook als het op een tag lijkt.</p>
103<h3>Opmaak</h3>
104<p>In de tekst van een hoofdstuk mag Markdown staan. Een regel die met <code>##</code> begint blijft een hoofdstuk en wordt geen gewone kop. <code>#</code> of <code>###</code> zonder die betekenis blijft gewone tekst.</p>
105<table>
106<thead><tr><th>Schrijfwijze</th><th>Resultaat</th></tr></thead>
107<tbody>
108<tr><td><code>- punt</code> of <code>* punt</code></td><td>Ongeordende lijst. Het streepje of sterretje staat aan het begin van de regel, gevolgd door een spatie.</td></tr>
109<tr><td><code>1. punt</code></td><td>Genummerde lijst. Het eerste nummer bepaalt waar de telling begint.</td></tr>
110<tr><td>twee spaties extra</td><td>Een geneste lijst. Spring minstens twee spaties verder in dan de regel erboven. Een lege regel tussen punten mag.</td></tr>
111<tr><td><code>**vet**</code> of <code>__vet__</code></td><td>Vet. <code>***beide***</code> is vet én cursief.</td></tr>
112<tr><td><code>*cursief*</code> of <code>_cursief_</code></td><td>Cursief. Een underscore midden in een woord, zoals <code>foo_bar</code>, blijft tekst.</td></tr>
113<tr><td><code>`code`</code></td><td>Code. Sterretjes en verwijzingen daarbinnen blijven letterlijk.</td></tr>
114<tr><td><code>&gt; citaat</code></td><td>Citaat. Zet het teken aan het begin van elke regel van het citaat.</td></tr>
115<tr><td><code>[tekst](https://…)</code></td><td>Externe link. Alleen <code>http</code>, <code>https</code> en <code>mailto</code> (met een <code>@</code>) worden een link, met <code>rel="noopener"</code>. <code>javascript:</code> en andere schema's blijven gewone tekst.</td></tr>
116</tbody>
117</table>
118<p>Vet, cursief en code mogen door elkaar, in een lijstpunt en om een verwijzing heen. Een <code>[[verwijzing]]</code> in een lijstpunt of in vette tekst blijft een verwijzing. Een backslash voor een sterretje, hekje of haakje maakt dat teken letterlijk.</p>
103<h3>Verwijzingen in de tekst</h3>
119<h3>Verwijzingen in de tekst</h3>
104<p>In de tekst van een pagina schrijf je een verwijzing tussen dubbele rechte haken. Het doel is altijd een slug, geen titel. Een eigen zichtbare tekst zet je achter een staande streep. De streep en de tekst zijn optioneel.</p>
120<p>In de tekst van een pagina schrijf je een verwijzing tussen dubbele rechte haken. Het doel is altijd een slug, geen titel. Een eigen zichtbare tekst zet je achter een staande streep. De streep en de tekst zijn optioneel.</p>
105<table>
121<table>
@@ -114,7 +130,8 @@ curl -sS -H 'Authorization: Bearer vb_JOUW_SLEUTEL' \
114</tbody>
130</tbody>
115</table>
131</table>
116<p>Een verwijzing die nergens heen wijst — onbekende pagina, onbekend anker, of een slug die niet aan het patroon voldoet — blijft in de tekst staan en is geen link. In de JSON heeft zo'n stuk <code>"broken": true</code> en geen <code>page</code>. In de app staat er „ontbreekt” achter. Een stuk als <code>&lt;script&gt;</code> of <code>javascript:</code> wordt gewone tekst en wordt niet uitgevoerd.</p>
132<p>Een verwijzing die nergens heen wijst — onbekende pagina, onbekend anker, of een slug die niet aan het patroon voldoet — blijft in de tekst staan en is geen link. In de JSON heeft zo'n stuk <code>"broken": true</code> en geen <code>page</code>. In de app staat er „ontbreekt” achter. Een stuk als <code>&lt;script&gt;</code> of <code>javascript:</code> wordt gewone tekst en wordt niet uitgevoerd.</p>
117<p>In het antwoord bestaat een alinea uit <code>inlines</code>. Een tekststuk is <code>{"type":"text","text":"…"}</code>. Een verwijzing is <code>{"type":"link","page":"oude-plein","anchor":"de-boom","text":"de boom","broken":false}</code>. <code>anchor</code> is <code>null</code> als de verwijzing de hele pagina bedoelt.</p>
133<p>In het antwoord heeft een blok een <code>type</code>. Een alinea is <code>{"type":"paragraph","inlines":[…]}</code>. Een lijst is <code>{"type":"list","ordered":false,"items":[{"blocks":[…]}]}</code>; bij een genummerde lijst is <code>ordered</code> <code>true</code> en staat <code>start</code> erbij als de telling niet bij 1 begint. Een citaat is <code>{"type":"quote","blocks":[…]}</code>. Geneste lijsten zitten in de <code>blocks</code> van een punt.</p>
134<p>Een tekststuk is <code>{"type":"text","text":"…"}</code>. Een verwijzing is <code>{"type":"link","page":"oude-plein","anchor":"de-boom","text":"de boom","broken":false}</code>. <code>anchor</code> is <code>null</code> als de verwijzing de hele pagina bedoelt. Vet is <code>{"type":"strong","inlines":[…]}</code>, cursief <code>{"type":"em","inlines":[…]}</code>, code <code>{"type":"code","text":"…"}</code> en een zichtbaar regeleinde <code>{"type":"break"}</code>. Een externe link is <code>{"type":"url","href":"https://…","inlines":[…]}</code>. Een verwijzing in het label van zo'n link wordt daar gewone tekst, zodat er geen link in een link ontstaat.</p>
118<h3>Voorbeeld</h3>
135<h3>Voorbeeld</h3>
119<pre><code>curl -sS -X POST \
136<pre><code>curl -sS -X POST \
120 -H 'Authorization: Bearer vb_JOUW_SLEUTEL' \
137 -H 'Authorization: Bearer vb_JOUW_SLEUTEL' \
web/index.php +0 −1
@@ -42,7 +42,6 @@ $showWiki = wikiVisible(($prefs['role'] ?? '') === 'admin');
42 42 <a href="#/instellingen" data-nav="/instellingen">Instellingen</a>
43 43 <?php if (($prefs['role'] ?? '') === 'admin'): ?>
44 44 <a href="#/beheer" data-nav="/beheer">Beheer</a>
45 <a href="#/sleutels" data-nav="/sleutels">Sleutels</a>
46 45 <a href="docs.php">API</a>
47 46 <?php endif ?>
48 47 </nav>
@@ -42,7 +42,6 @@ $showWiki = wikiVisible(($prefs['role'] ?? '') === 'admin');
42 <a href="#/instellingen" data-nav="/instellingen">Instellingen</a>
42 <a href="#/instellingen" data-nav="/instellingen">Instellingen</a>
43 <?php if (($prefs['role'] ?? '') === 'admin'): ?>
43 <?php if (($prefs['role'] ?? '') === 'admin'): ?>
44 <a href="#/beheer" data-nav="/beheer">Beheer</a>
44 <a href="#/beheer" data-nav="/beheer">Beheer</a>
45 <a href="#/sleutels" data-nav="/sleutels">Sleutels</a>
46 <a href="docs.php">API</a>
45 <a href="docs.php">API</a>
47 <?php endif ?>
46 <?php endif ?>
48 </nav>
47 </nav>
web/lib/Wiki.php +562 −31
@@ -276,34 +276,506 @@ function wikiAssignAnchors(array $sections): array {
276 276 return $chapters;
277 277 }
278 278
279 /** @return list<array{inlines:list<array<string,mixed>>}> */
279 /**
280 * Blokken binnen een hoofdstuk. Een lege regel scheidt alinea's. Een gewone
281 * regeleinde wordt een spatie, twee spaties of een backslash aan het regeleinde
282 * een zichtbare breuk. Lijsten, citaten, nadruk, code en externe links komen
283 * hierbij; ##-hoofdstukken zijn dan al apart gezet.
284 *
285 * @return list<array<string,mixed>>
286 */
280 287 function wikiParagraphs(string $body): array {
281 $parts = preg_split("/\n[ \t]*\n/u", $body) ?: [];
288 $body = str_replace(["\r\n", "\r"], "\n", $body);
289 $lines = $body === '' ? [] : explode("\n", $body);
290 return wikiParseBlockLines($lines, 0, count($lines), 0)['blocks'];
291 }
292
293 /** @return array{blocks:list<array<string,mixed>>,next:int} */
294 function wikiParseBlockLines(array $lines, int $i, int $n, int $depth): array {
295 if ($depth > 30) {
296 $text = trim(implode(' ', array_map(fn(string $line): string => trim($line), $lines)));
297 $inlines = $text === '' ? [] : wikiParseInlines($text);
298 return ['blocks' => $inlines ? [['type' => 'paragraph', 'inlines' => $inlines]] : [], 'next' => $n];
299 }
282 300 $blocks = [];
283 foreach ($parts as $part) {
284 $lines = array_values(array_filter(array_map('trim', explode("\n", $part)), fn(string $line): bool => $line !== ''));
285 if (!$lines) continue;
286 $inlines = wikiParseInlines(implode(' ', $lines));
287 if ($inlines) $blocks[] = ['inlines' => $inlines];
301 while ($i < $n) {
302 if (trim($lines[$i]) === '') { $i++; continue; }
303 $list = wikiMatchList($lines[$i]);
304 if ($list) {
305 $parsed = wikiParseList($lines, $i, $n, $list['indent'], $list['ordered'], $depth);
306 if ($parsed['block']) $blocks[] = $parsed['block'];
307 $i = $parsed['next'];
308 continue;
309 }
310 if (wikiIsQuoteLine($lines[$i])) {
311 $parsed = wikiParseQuote($lines, $i, $n, $depth);
312 if ($parsed['block']) $blocks[] = $parsed['block'];
313 $i = $parsed['next'];
314 continue;
315 }
316 $parsed = wikiParseParagraph($lines, $i, $n);
317 if ($parsed['block']) $blocks[] = $parsed['block'];
318 $i = $parsed['next'];
319 }
320 return ['blocks' => $blocks, 'next' => $i];
321 }
322
323 function wikiIsQuoteLine(string $line): bool {
324 return preg_match('/^[ \t]*>/u', $line) === 1;
325 }
326
327 /** @return array{block:?array<string,mixed>,next:int} */
328 function wikiParseQuote(array $lines, int $i, int $n, int $depth): array {
329 $collected = [];
330 while ($i < $n && preg_match('/^[ \t]*> ?(.*)$/u', $lines[$i], $match)) {
331 $collected[] = $match[1];
332 $i++;
333 }
334 $inner = wikiParseBlockLines($collected, 0, count($collected), $depth + 1)['blocks'];
335 return ['block' => $inner ? ['type' => 'quote', 'blocks' => $inner] : null, 'next' => $i];
336 }
337
338 /** @return ?array{indent:int,ordered:bool,number:?int,text:string} */
339 function wikiMatchList(string $line): ?array {
340 if (preg_match('/^([ \t]*)([-*]|\d{1,9}\.)([ \t]+)(.*)$/u', $line, $match) !== 1) return null;
341 $marker = $match[2];
342 $ordered = str_ends_with($marker, '.');
343 return [
344 'indent' => wikiIndentColumns($match[1]),
345 'ordered' => $ordered,
346 'number' => $ordered ? (int)$marker : null,
347 'text' => $match[4],
348 ];
349 }
350
351 function wikiIndentColumns(string $whitespace): int {
352 $columns = 0;
353 $length = strlen($whitespace);
354 for ($i = 0; $i < $length; $i++) $columns += $whitespace[$i] === "\t" ? 4 : 1;
355 return $columns;
356 }
357
358 function wikiLeadingColumns(string $line): int {
359 if (preg_match('/^[ \t]*/', $line, $match) !== 1) return 0;
360 return wikiIndentColumns($match[0]);
361 }
362
363 /** @return array{block:?array<string,mixed>,next:int} */
364 function wikiParseList(array $lines, int $i, int $n, int $base, bool $ordered, int $depth): array {
365 $items = [];
366 $start = null;
367 while ($i < $n) {
368 while ($i < $n && trim($lines[$i]) === '') {
369 $k = $i + 1;
370 while ($k < $n && trim($lines[$k]) === '') $k++;
371 $sibling = $k < $n ? wikiMatchList($lines[$k]) : null;
372 if ($sibling && $sibling['indent'] === $base && $sibling['ordered'] === $ordered) {
373 $i = $k;
374 break;
375 }
376 break 2;
377 }
378 if ($i >= $n) break;
379 $item = wikiMatchList($lines[$i]);
380 if (!$item || $item['indent'] !== $base || $item['ordered'] !== $ordered) break;
381 if ($start === null) $start = $item['number'];
382 $i++;
383 $body = [$item['text']];
384 while ($i < $n) {
385 if (trim($lines[$i]) === '') {
386 $k = $i + 1;
387 while ($k < $n && trim($lines[$k]) === '') $k++;
388 if ($k >= $n) { $i = $n; break; }
389 $next = wikiMatchList($lines[$k]);
390 if ($next && $next['indent'] === $base && $next['ordered'] === $ordered) {
391 $i = $k;
392 break;
393 }
394 if ($next && $next['indent'] <= $base) break;
395 if (wikiLeadingColumns($lines[$k]) <= $base) break;
396 $body[] = '';
397 $i++;
398 continue;
399 }
400 $next = wikiMatchList($lines[$i]);
401 if ($next && $next['indent'] <= $base) break;
402 if (wikiLeadingColumns($lines[$i]) <= $base) break;
403 $body[] = $lines[$i];
404 $i++;
405 }
406 $items[] = ['blocks' => wikiParseBlockLines($body, 0, count($body), $depth + 1)['blocks']];
407 }
408 if (!$items) return ['block' => null, 'next' => $i];
409 $block = ['type' => 'list', 'ordered' => $ordered, 'items' => $items];
410 if ($ordered && $start !== null && $start !== 1) $block['start'] = $start;
411 return ['block' => $block, 'next' => $i];
412 }
413
414 /** @return array{block:?array<string,mixed>,next:int} */
415 function wikiParseParagraph(array $lines, int $i, int $n): array {
416 $chunks = [];
417 while ($i < $n) {
418 $line = $lines[$i];
419 if (trim($line) === '' || wikiMatchList($line) || wikiIsQuoteLine($line)) break;
420 $chunks[] = $line;
421 $i++;
422 }
423 $inlines = wikiJoinParagraph($chunks);
424 return ['block' => $inlines ? ['type' => 'paragraph', 'inlines' => $inlines] : null, 'next' => $i];
425 }
426
427 /** @return list<array<string,mixed>> */
428 function wikiJoinParagraph(array $rawLines): array {
429 $segments = [];
430 foreach ($rawLines as $line) {
431 if (trim($line) === '') continue;
432 [$text, $hard] = wikiSplitHard($line);
433 if ($text === '' && !$hard) continue;
434 $segments[] = ['text' => $text, 'hard' => $hard];
288 435 }
289 return $blocks;
436 if (!$segments) return [];
437 $joined = '';
438 foreach ($segments as $index => $segment) {
439 if ($index > 0) $joined .= $segments[$index - 1]['hard'] ? "\n" : ' ';
440 $joined .= $segment['text'];
441 }
442 return wikiParseInlines($joined);
443 }
444
445 /** @return array{0:string,1:bool} */
446 function wikiSplitHard(string $line): array {
447 if (preg_match('/^(.*?)([ \t]{2,})$/u', $line, $match) === 1 && trim($match[1]) !== '') {
448 return [trim($match[1]), true];
449 }
450 $trimmed = rtrim($line, " \t");
451 if ($trimmed !== '' && str_ends_with($trimmed, '\\') && wikiEndsWithOddBackslash($trimmed)) {
452 return [trim(substr($trimmed, 0, -1)), true];
453 }
454 return [trim($line), false];
455 }
456
457 function wikiEndsWithOddBackslash(string $line): bool {
458 $count = 0;
459 for ($i = strlen($line) - 1; $i >= 0 && $line[$i] === '\\'; $i--) $count++;
460 return $count % 2 === 1;
290 461 }
291 462
292 463 /** @return list<array<string,mixed>> */
293 464 function wikiParseInlines(string $text): array {
294 $inlines = [];
295 $offset = 0;
296 if (preg_match_all('/\[\[([^\[\]\n]+)\]\]/u', $text, $matches, PREG_OFFSET_CAPTURE)) {
297 foreach ($matches[0] as $index => $full) {
298 $start = $full[1];
299 if ($start > $offset) {
300 $inlines[] = ['type' => 'text', 'text' => substr($text, $offset, $start - $offset)];
465 if ($text === '') return [];
466 $scanned = wikiScanInlines($text, 0, strlen($text), false);
467 return wikiMatchEmphasis($scanned['tokens']);
468 }
469
470 /**
471 * @return array{tokens:list<array<string,mixed>>,next:int,stopped:bool}
472 */
473 function wikiScanInlines(string $text, int $i, int $end, bool $inLabel): array {
474 $tokens = [];
475 $buffer = '';
476 $flush = function () use (&$tokens, &$buffer): void {
477 if ($buffer !== '') {
478 $tokens[] = ['kind' => 'text', 'text' => $buffer];
479 $buffer = '';
480 }
481 };
482 while ($i < $end) {
483 if ($inLabel && $text[$i] === ']') {
484 $flush();
485 return ['tokens' => $tokens, 'next' => $i, 'stopped' => true];
486 }
487 if ($text[$i] === "\n") {
488 $flush();
489 $tokens[] = ['kind' => 'break'];
490 $i++;
491 continue;
492 }
493 if ($text[$i] === '\\' && $i + 1 < $end) {
494 $next = wikiCharAt($text, $i + 1, $end);
495 if (wikiEscapable($next)) {
496 $buffer .= $next;
497 $i += 1 + strlen($next);
498 continue;
499 }
500 }
501 if ($text[$i] === '`') {
502 $code = wikiTryCode($text, $i, $end);
503 if ($code) {
504 $flush();
505 $tokens[] = $code['token'];
506 $i = $code['next'];
507 continue;
301 508 }
302 $inlines[] = wikiRawLink($matches[1][$index][0]);
303 $offset = $start + strlen($full[0]);
304 509 }
510 if ($text[$i] === '[' && $i + 1 < $end && $text[$i + 1] === '[') {
511 $link = wikiTryWikiLink($text, $i, $end);
512 if ($link) {
513 $flush();
514 $tokens[] = ['kind' => 'wiki', 'link' => $link['link']];
515 $i = $link['next'];
516 continue;
517 }
518 }
519 if (!$inLabel && $text[$i] === '[') {
520 $link = wikiTryExternalLink($text, $i, $end);
521 if ($link) {
522 $flush();
523 $tokens[] = $link['token'];
524 $i = $link['next'];
525 continue;
526 }
527 }
528 if ($text[$i] === '*' || $text[$i] === '_') {
529 $marker = $text[$i];
530 $run = 0;
531 while ($i + $run < $end && $text[$i + $run] === $marker) $run++;
532 $before = wikiCharClass(wikiPrevChar($text, $i));
533 $after = wikiCharClass(wikiCharAt($text, $i + $run, $end));
534 $flush();
535 $tokens[] = [
536 'kind' => 'delim',
537 'marker' => $marker,
538 'len' => $run,
539 'canOpen' => wikiCanOpen($before, $after, $marker),
540 'canClose' => wikiCanClose($before, $after, $marker),
541 ];
542 $i += $run;
543 continue;
544 }
545 $char = wikiCharAt($text, $i, $end);
546 if ($char === '') { $i++; continue; }
547 $buffer .= $char;
548 $i += strlen($char);
305 549 }
306 if ($offset < strlen($text)) $inlines[] = ['type' => 'text', 'text' => substr($text, $offset)];
550 $flush();
551 return ['tokens' => $tokens, 'next' => $i, 'stopped' => false];
552 }
553
554 function wikiEscapable(string $char): bool {
555 return $char !== '' && str_contains('\\`*_{}[]()#+-.!|>', $char);
556 }
557
558 function wikiCharAt(string $text, int $byte, int $end): string {
559 if ($byte < 0 || $byte >= $end) return '';
560 $slice = substr($text, $byte, min(4, $end - $byte));
561 if (preg_match('/\A./us', $slice, $match) === 1) return $match[0];
562 return $text[$byte];
563 }
564
565 function wikiPrevChar(string $text, int $byte): string {
566 if ($byte <= 0) return '';
567 $start = max(0, $byte - 4);
568 $slice = substr($text, $start, $byte - $start);
569 if (preg_match('/.\z/us', $slice, $match) === 1) return $match[0];
570 return $text[$byte - 1];
571 }
572
573 function wikiCharClass(string $char): string {
574 if ($char === '') return 'edge';
575 if (preg_match('/\A\s\z/u', $char) === 1) return 'space';
576 if (preg_match('/\A[\p{L}\p{N}]\z/u', $char) === 1) return 'word';
577 return 'punct';
578 }
579
580 function wikiLeftFlanking(string $before, string $after): bool {
581 if ($after === 'space' || $after === 'edge') return false;
582 if ($after === 'punct' && $before !== 'space' && $before !== 'edge' && $before !== 'punct') return false;
583 return true;
584 }
585
586 function wikiRightFlanking(string $before, string $after): bool {
587 if ($before === 'space' || $before === 'edge') return false;
588 if ($before === 'punct' && $after !== 'space' && $after !== 'edge' && $after !== 'punct') return false;
589 return true;
590 }
591
592 function wikiCanOpen(string $before, string $after, string $marker): bool {
593 if (!wikiLeftFlanking($before, $after)) return false;
594 if ($marker === '_' && wikiRightFlanking($before, $after) && $before !== 'punct') return false;
595 return true;
596 }
597
598 function wikiCanClose(string $before, string $after, string $marker): bool {
599 if (!wikiRightFlanking($before, $after)) return false;
600 if ($marker === '_' && wikiLeftFlanking($before, $after) && $after !== 'punct') return false;
601 return true;
602 }
603
604 /** @return ?array{token:array<string,mixed>,next:int} */
605 function wikiTryCode(string $text, int $i, int $end): ?array {
606 if ($text[$i] !== '`') return null;
607 $run = 0;
608 while ($i + $run < $end && $text[$i + $run] === '`') $run++;
609 $j = $i + $run;
610 while ($j < $end) {
611 if ($text[$j] !== '`') { $j++; continue; }
612 $close = 0;
613 while ($j + $close < $end && $text[$j + $close] === '`') $close++;
614 if ($close === $run) {
615 $content = substr($text, $i + $run, $j - ($i + $run));
616 $content = str_replace("\n", ' ', $content);
617 if (strlen($content) >= 2 && $content[0] === ' ' && str_ends_with($content, ' ') && trim($content) !== '') {
618 $content = substr($content, 1, -1);
619 }
620 return ['token' => ['kind' => 'code', 'text' => $content], 'next' => $j + $run];
621 }
622 $j += $close;
623 }
624 return null;
625 }
626
627 /** @return ?array{link:array<string,mixed>,next:int} */
628 function wikiTryWikiLink(string $text, int $i, int $end): ?array {
629 if ($i + 3 >= $end || $text[$i] !== '[' || $text[$i + 1] !== '[') return null;
630 if (preg_match('/\A\[\[([^\[\]\n]+)\]\]/u', substr($text, $i, $end - $i), $match) !== 1) return null;
631 return ['link' => wikiRawLink($match[1]), 'next' => $i + strlen($match[0])];
632 }
633
634 /** @return ?array{token:array<string,mixed>,next:int} */
635 function wikiTryExternalLink(string $text, int $i, int $end): ?array {
636 if ($text[$i] !== '[') return null;
637 $label = wikiScanInlines($text, $i + 1, $end, true);
638 if (!$label['stopped']) return null;
639 $j = $label['next'];
640 if ($j + 1 >= $end || $text[$j + 1] !== '(') return null;
641 $urlStart = $j + 2;
642 if ($urlStart >= $end) return null;
643 $url = '';
644 $next = $urlStart;
645 if ($text[$urlStart] === '<') {
646 $close = strpos($text, '>', $urlStart + 1);
647 if ($close === false || $close >= $end || $close + 1 >= $end || $text[$close + 1] !== ')') return null;
648 $url = substr($text, $urlStart + 1, $close - $urlStart - 1);
649 $next = $close + 2;
650 } else {
651 $depth = 0;
652 $k = $urlStart;
653 while ($k < $end) {
654 $char = wikiCharAt($text, $k, $end);
655 if ($char === '\\' && $k + strlen($char) < $end) {
656 $escaped = wikiCharAt($text, $k + 1, $end);
657 if (wikiEscapable($escaped)) {
658 $url .= $escaped;
659 $k += 1 + strlen($escaped);
660 continue;
661 }
662 }
663 if ($char === '(') { $depth++; $url .= '('; $k++; continue; }
664 if ($char === ')') {
665 if ($depth === 0) break;
666 $depth--;
667 $url .= ')';
668 $k++;
669 continue;
670 }
671 if (wikiCharClass($char) === 'space') return null;
672 $url .= $char;
673 $k += strlen($char);
674 }
675 if ($k >= $end || $text[$k] !== ')') return null;
676 $next = $k + 1;
677 }
678 $safe = wikiSafeUrl($url);
679 if ($safe === null) return null;
680 $children = $label['tokens'];
681 if (!$children) $children = [['kind' => 'text', 'text' => $safe]];
682 return ['token' => ['kind' => 'url', 'href' => $safe, 'children' => $children], 'next' => $next];
683 }
684
685 function wikiSafeUrl(string $url): ?string {
686 $url = trim($url);
687 if ($url === '' || strlen($url) > 2000) return null;
688 if (preg_match('/[\x00-\x20\x7F<>"\'\\\\]/', $url) === 1) return null;
689 if (preg_match('#\Ahttps?://[^\s/]+#i', $url) === 1) return $url;
690 if (preg_match('#\Amailto:[^@\s]+@[^@\s]+#i', $url) === 1) return $url;
691 return null;
692 }
693
694 /** @param list<array<string,mixed>> $tokens */
695 function wikiMatchEmphasis(array $tokens): array {
696 $budget = count($tokens) + 1;
697 foreach ($tokens as $token) {
698 if (($token['kind'] ?? '') === 'delim') $budget += (int)($token['len'] ?? 0);
699 }
700 $guard = 0;
701 while ($guard++ < $budget) {
702 $found = wikiFirstEmphasisMatch($tokens);
703 if ($found === null) break;
704 [$open, $close, $use] = $found;
705 $inner = array_slice($tokens, $open + 1, $close - $open - 1);
706 $tokens[$open]['len'] -= $use;
707 $tokens[$close]['len'] -= $use;
708 $node = ['kind' => $use === 2 ? 'strong' : 'em', 'children' => $inner];
709 $replacement = [];
710 if ($tokens[$open]['len'] > 0) $replacement[] = $tokens[$open];
711 $replacement[] = $node;
712 if ($tokens[$close]['len'] > 0) $replacement[] = $tokens[$close];
713 array_splice($tokens, $open, $close - $open + 1, $replacement);
714 }
715 return wikiTokensToInlines($tokens);
716 }
717
718 /** @param list<array<string,mixed>> $tokens
719 * @return ?array{0:int,1:int,2:int}
720 */
721 function wikiFirstEmphasisMatch(array $tokens): ?array {
722 $count = count($tokens);
723 for ($close = 0; $close < $count; $close++) {
724 $closer = $tokens[$close];
725 if (($closer['kind'] ?? '') !== 'delim' || empty($closer['canClose']) || (int)$closer['len'] < 1) continue;
726 for ($open = $close - 1; $open >= 0; $open--) {
727 $opener = $tokens[$open];
728 if (($opener['kind'] ?? '') !== 'delim' || empty($opener['canOpen']) || (int)$opener['len'] < 1) continue;
729 if ($opener['marker'] !== $closer['marker']) continue;
730 if (!wikiDelimLengthsOk((int)$opener['len'], (int)$closer['len'])) continue;
731 $use = ((int)$opener['len'] >= 2 && (int)$closer['len'] >= 2) ? 2 : 1;
732 return [$open, $close, $use];
733 }
734 }
735 return null;
736 }
737
738 function wikiDelimLengthsOk(int $opener, int $closer): bool {
739 if ($opener < 1 || $closer < 1) return false;
740 if (($opener % 3 === 0 || $closer % 3 === 0) && (($opener + $closer) % 3 !== 0)) return false;
741 return true;
742 }
743
744 /** @param list<array<string,mixed>> $tokens
745 * @return list<array<string,mixed>>
746 */
747 function wikiTokensToInlines(array $tokens): array {
748 $inlines = [];
749 $buffer = '';
750 $flush = function () use (&$inlines, &$buffer): void {
751 if ($buffer !== '') {
752 $inlines[] = ['type' => 'text', 'text' => $buffer];
753 $buffer = '';
754 }
755 };
756 foreach ($tokens as $token) {
757 $kind = $token['kind'] ?? '';
758 if ($kind === 'text') { $buffer .= $token['text']; continue; }
759 if ($kind === 'delim') {
760 $length = (int)($token['len'] ?? 0);
761 if ($length > 0) $buffer .= str_repeat((string)$token['marker'], $length);
762 continue;
763 }
764 $flush();
765 if ($kind === 'break') { $inlines[] = ['type' => 'break']; continue; }
766 if ($kind === 'code') { $inlines[] = ['type' => 'code', 'text' => (string)($token['text'] ?? '')]; continue; }
767 if ($kind === 'wiki') { $inlines[] = $token['link']; continue; }
768 if ($kind === 'url') {
769 $children = wikiMatchEmphasis($token['children'] ?? []);
770 if (!$children) $children = [['type' => 'text', 'text' => (string)$token['href']]];
771 $inlines[] = ['type' => 'url', 'href' => (string)$token['href'], 'inlines' => $children];
772 continue;
773 }
774 if ($kind === 'strong' || $kind === 'em') {
775 $inlines[] = ['type' => $kind, 'inlines' => wikiTokensToInlines($token['children'] ?? [])];
776 }
777 }
778 $flush();
307 779 return $inlines;
308 780 }
309 781
@@ -388,27 +860,86 @@ function wikiResolveLink(array $link, string $pageSlug, array $catalog): array {
388 860 function wikiResolveChapters(array $chapters, string $pageSlug, array $catalog): array {
389 861 $resolved = [];
390 862 foreach ($chapters as $chapter) {
391 $blocks = [];
392 foreach ($chapter['blocks'] as $block) {
393 $inlines = [];
394 foreach ($block['inlines'] as $inline) {
395 if (($inline['type'] ?? '') === 'text') {
396 if (($inline['text'] ?? '') !== '') $inlines[] = ['type' => 'text', 'text' => $inline['text']];
397 continue;
398 }
399 $inlines[] = wikiResolveLink($inline, $pageSlug, $catalog);
400 }
401 if ($inlines) $blocks[] = ['inlines' => $inlines];
402 }
403 863 $resolved[] = [
404 864 'anchor' => $chapter['anchor'],
405 865 'title' => $chapter['title'],
406 'blocks' => $blocks,
866 'blocks' => wikiResolveBlocks($chapter['blocks'], $pageSlug, $catalog),
407 867 ];
408 868 }
409 869 return $resolved;
410 870 }
411 871
872 /** @param list<array<string,mixed>> $blocks
873 * @return list<array<string,mixed>>
874 */
875 function wikiResolveBlocks(array $blocks, string $pageSlug, array $catalog): array {
876 $resolved = [];
877 foreach ($blocks as $block) {
878 $type = $block['type'] ?? 'paragraph';
879 if ($type === 'list') {
880 $items = [];
881 foreach ($block['items'] ?? [] as $item) {
882 $items[] = ['blocks' => wikiResolveBlocks($item['blocks'] ?? [], $pageSlug, $catalog)];
883 }
884 $copy = ['type' => 'list', 'ordered' => (bool)($block['ordered'] ?? false), 'items' => $items];
885 if (isset($block['start'])) $copy['start'] = (int)$block['start'];
886 $resolved[] = $copy;
887 continue;
888 }
889 if ($type === 'quote') {
890 $inner = wikiResolveBlocks($block['blocks'] ?? [], $pageSlug, $catalog);
891 if ($inner) $resolved[] = ['type' => 'quote', 'blocks' => $inner];
892 continue;
893 }
894 $inlines = wikiResolveInlines($block['inlines'] ?? [], $pageSlug, $catalog, false);
895 if ($inlines) $resolved[] = ['type' => 'paragraph', 'inlines' => $inlines];
896 }
897 return $resolved;
898 }
899
900 /** @param list<array<string,mixed>> $inlines
901 * @return list<array<string,mixed>>
902 */
903 function wikiResolveInlines(array $inlines, string $pageSlug, array $catalog, bool $insideUrl): array {
904 $resolved = [];
905 foreach ($inlines as $inline) {
906 $type = $inline['type'] ?? '';
907 if ($type === 'text') {
908 if (($inline['text'] ?? '') !== '') $resolved[] = ['type' => 'text', 'text' => $inline['text']];
909 continue;
910 }
911 if ($type === 'break') { $resolved[] = ['type' => 'break']; continue; }
912 if ($type === 'code') { $resolved[] = ['type' => 'code', 'text' => (string)($inline['text'] ?? '')]; continue; }
913 if ($type === 'link') {
914 $link = wikiResolveLink($inline, $pageSlug, $catalog);
915 if ($insideUrl) {
916 if ($link['text'] !== '') $resolved[] = ['type' => 'text', 'text' => $link['text']];
917 continue;
918 }
919 $resolved[] = $link;
920 continue;
921 }
922 if ($type === 'strong' || $type === 'em') {
923 $resolved[] = [
924 'type' => $type,
925 'inlines' => wikiResolveInlines($inline['inlines'] ?? [], $pageSlug, $catalog, $insideUrl),
926 ];
927 continue;
928 }
929 if ($type === 'url') {
930 $href = wikiSafeUrl((string)($inline['href'] ?? ''));
931 if ($href === null) {
932 foreach (wikiResolveInlines($inline['inlines'] ?? [], $pageSlug, $catalog, true) as $child) $resolved[] = $child;
933 continue;
934 }
935 $children = wikiResolveInlines($inline['inlines'] ?? [], $pageSlug, $catalog, true);
936 if (!$children) $children = [['type' => 'text', 'text' => $href]];
937 $resolved[] = ['type' => 'url', 'href' => $href, 'inlines' => $children];
938 }
939 }
940 return $resolved;
941 }
942
412 943 function loadWikiPage(string $slug): array {
413 944 $page = wikiPageRow($slug);
414 945 $category = query('SELECT slug, title FROM wiki_categories WHERE id=?', [$page['category_id']])->fetch();
@@ -276,34 +276,506 @@ function wikiAssignAnchors(array $sections): array {
276 return $chapters;
276 return $chapters;
277}
277}
278
278
279/** @return list<array{inlines:list<array<string,mixed>>}> */
279/**
280 * Blokken binnen een hoofdstuk. Een lege regel scheidt alinea's. Een gewone
281 * regeleinde wordt een spatie, twee spaties of een backslash aan het regeleinde
282 * een zichtbare breuk. Lijsten, citaten, nadruk, code en externe links komen
283 * hierbij; ##-hoofdstukken zijn dan al apart gezet.
284 *
285 * @return list<array<string,mixed>>
286 */
280function wikiParagraphs(string $body): array {
287function wikiParagraphs(string $body): array {
281 $parts = preg_split("/\n[ \t]*\n/u", $body) ?: [];
288 $body = str_replace(["\r\n", "\r"], "\n", $body);
289 $lines = $body === '' ? [] : explode("\n", $body);
290 return wikiParseBlockLines($lines, 0, count($lines), 0)['blocks'];
291}
292
293/** @return array{blocks:list<array<string,mixed>>,next:int} */
294function wikiParseBlockLines(array $lines, int $i, int $n, int $depth): array {
295 if ($depth > 30) {
296 $text = trim(implode(' ', array_map(fn(string $line): string => trim($line), $lines)));
297 $inlines = $text === '' ? [] : wikiParseInlines($text);
298 return ['blocks' => $inlines ? [['type' => 'paragraph', 'inlines' => $inlines]] : [], 'next' => $n];
299 }
282 $blocks = [];
300 $blocks = [];
283 foreach ($parts as $part) {
301 while ($i < $n) {
284 $lines = array_values(array_filter(array_map('trim', explode("\n", $part)), fn(string $line): bool => $line !== ''));
302 if (trim($lines[$i]) === '') { $i++; continue; }
285 if (!$lines) continue;
303 $list = wikiMatchList($lines[$i]);
286 $inlines = wikiParseInlines(implode(' ', $lines));
304 if ($list) {
287 if ($inlines) $blocks[] = ['inlines' => $inlines];
305 $parsed = wikiParseList($lines, $i, $n, $list['indent'], $list['ordered'], $depth);
306 if ($parsed['block']) $blocks[] = $parsed['block'];
307 $i = $parsed['next'];
308 continue;
309 }
310 if (wikiIsQuoteLine($lines[$i])) {
311 $parsed = wikiParseQuote($lines, $i, $n, $depth);
312 if ($parsed['block']) $blocks[] = $parsed['block'];
313 $i = $parsed['next'];
314 continue;
315 }
316 $parsed = wikiParseParagraph($lines, $i, $n);
317 if ($parsed['block']) $blocks[] = $parsed['block'];
318 $i = $parsed['next'];
319 }
320 return ['blocks' => $blocks, 'next' => $i];
321}
322
323function wikiIsQuoteLine(string $line): bool {
324 return preg_match('/^[ \t]*>/u', $line) === 1;
325}
326
327/** @return array{block:?array<string,mixed>,next:int} */
328function wikiParseQuote(array $lines, int $i, int $n, int $depth): array {
329 $collected = [];
330 while ($i < $n && preg_match('/^[ \t]*> ?(.*)$/u', $lines[$i], $match)) {
331 $collected[] = $match[1];
332 $i++;
333 }
334 $inner = wikiParseBlockLines($collected, 0, count($collected), $depth + 1)['blocks'];
335 return ['block' => $inner ? ['type' => 'quote', 'blocks' => $inner] : null, 'next' => $i];
336}
337
338/** @return ?array{indent:int,ordered:bool,number:?int,text:string} */
339function wikiMatchList(string $line): ?array {
340 if (preg_match('/^([ \t]*)([-*]|\d{1,9}\.)([ \t]+)(.*)$/u', $line, $match) !== 1) return null;
341 $marker = $match[2];
342 $ordered = str_ends_with($marker, '.');
343 return [
344 'indent' => wikiIndentColumns($match[1]),
345 'ordered' => $ordered,
346 'number' => $ordered ? (int)$marker : null,
347 'text' => $match[4],
348 ];
349}
350
351function wikiIndentColumns(string $whitespace): int {
352 $columns = 0;
353 $length = strlen($whitespace);
354 for ($i = 0; $i < $length; $i++) $columns += $whitespace[$i] === "\t" ? 4 : 1;
355 return $columns;
356}
357
358function wikiLeadingColumns(string $line): int {
359 if (preg_match('/^[ \t]*/', $line, $match) !== 1) return 0;
360 return wikiIndentColumns($match[0]);
361}
362
363/** @return array{block:?array<string,mixed>,next:int} */
364function wikiParseList(array $lines, int $i, int $n, int $base, bool $ordered, int $depth): array {
365 $items = [];
366 $start = null;
367 while ($i < $n) {
368 while ($i < $n && trim($lines[$i]) === '') {
369 $k = $i + 1;
370 while ($k < $n && trim($lines[$k]) === '') $k++;
371 $sibling = $k < $n ? wikiMatchList($lines[$k]) : null;
372 if ($sibling && $sibling['indent'] === $base && $sibling['ordered'] === $ordered) {
373 $i = $k;
374 break;
375 }
376 break 2;
377 }
378 if ($i >= $n) break;
379 $item = wikiMatchList($lines[$i]);
380 if (!$item || $item['indent'] !== $base || $item['ordered'] !== $ordered) break;
381 if ($start === null) $start = $item['number'];
382 $i++;
383 $body = [$item['text']];
384 while ($i < $n) {
385 if (trim($lines[$i]) === '') {
386 $k = $i + 1;
387 while ($k < $n && trim($lines[$k]) === '') $k++;
388 if ($k >= $n) { $i = $n; break; }
389 $next = wikiMatchList($lines[$k]);
390 if ($next && $next['indent'] === $base && $next['ordered'] === $ordered) {
391 $i = $k;
392 break;
393 }
394 if ($next && $next['indent'] <= $base) break;
395 if (wikiLeadingColumns($lines[$k]) <= $base) break;
396 $body[] = '';
397 $i++;
398 continue;
399 }
400 $next = wikiMatchList($lines[$i]);
401 if ($next && $next['indent'] <= $base) break;
402 if (wikiLeadingColumns($lines[$i]) <= $base) break;
403 $body[] = $lines[$i];
404 $i++;
405 }
406 $items[] = ['blocks' => wikiParseBlockLines($body, 0, count($body), $depth + 1)['blocks']];
407 }
408 if (!$items) return ['block' => null, 'next' => $i];
409 $block = ['type' => 'list', 'ordered' => $ordered, 'items' => $items];
410 if ($ordered && $start !== null && $start !== 1) $block['start'] = $start;
411 return ['block' => $block, 'next' => $i];
412}
413
414/** @return array{block:?array<string,mixed>,next:int} */
415function wikiParseParagraph(array $lines, int $i, int $n): array {
416 $chunks = [];
417 while ($i < $n) {
418 $line = $lines[$i];
419 if (trim($line) === '' || wikiMatchList($line) || wikiIsQuoteLine($line)) break;
420 $chunks[] = $line;
421 $i++;
422 }
423 $inlines = wikiJoinParagraph($chunks);
424 return ['block' => $inlines ? ['type' => 'paragraph', 'inlines' => $inlines] : null, 'next' => $i];
425}
426
427/** @return list<array<string,mixed>> */
428function wikiJoinParagraph(array $rawLines): array {
429 $segments = [];
430 foreach ($rawLines as $line) {
431 if (trim($line) === '') continue;
432 [$text, $hard] = wikiSplitHard($line);
433 if ($text === '' && !$hard) continue;
434 $segments[] = ['text' => $text, 'hard' => $hard];
288 }
435 }
289 return $blocks;
436 if (!$segments) return [];
437 $joined = '';
438 foreach ($segments as $index => $segment) {
439 if ($index > 0) $joined .= $segments[$index - 1]['hard'] ? "\n" : ' ';
440 $joined .= $segment['text'];
441 }
442 return wikiParseInlines($joined);
443}
444
445/** @return array{0:string,1:bool} */
446function wikiSplitHard(string $line): array {
447 if (preg_match('/^(.*?)([ \t]{2,})$/u', $line, $match) === 1 && trim($match[1]) !== '') {
448 return [trim($match[1]), true];
449 }
450 $trimmed = rtrim($line, " \t");
451 if ($trimmed !== '' && str_ends_with($trimmed, '\\') && wikiEndsWithOddBackslash($trimmed)) {
452 return [trim(substr($trimmed, 0, -1)), true];
453 }
454 return [trim($line), false];
455}
456
457function wikiEndsWithOddBackslash(string $line): bool {
458 $count = 0;
459 for ($i = strlen($line) - 1; $i >= 0 && $line[$i] === '\\'; $i--) $count++;
460 return $count % 2 === 1;
290}
461}
291
462
292/** @return list<array<string,mixed>> */
463/** @return list<array<string,mixed>> */
293function wikiParseInlines(string $text): array {
464function wikiParseInlines(string $text): array {
294 $inlines = [];
465 if ($text === '') return [];
295 $offset = 0;
466 $scanned = wikiScanInlines($text, 0, strlen($text), false);
296 if (preg_match_all('/\[\[([^\[\]\n]+)\]\]/u', $text, $matches, PREG_OFFSET_CAPTURE)) {
467 return wikiMatchEmphasis($scanned['tokens']);
297 foreach ($matches[0] as $index => $full) {
468}
298 $start = $full[1];
469
299 if ($start > $offset) {
470/**
300 $inlines[] = ['type' => 'text', 'text' => substr($text, $offset, $start - $offset)];
471 * @return array{tokens:list<array<string,mixed>>,next:int,stopped:bool}
472 */
473function wikiScanInlines(string $text, int $i, int $end, bool $inLabel): array {
474 $tokens = [];
475 $buffer = '';
476 $flush = function () use (&$tokens, &$buffer): void {
477 if ($buffer !== '') {
478 $tokens[] = ['kind' => 'text', 'text' => $buffer];
479 $buffer = '';
480 }
481 };
482 while ($i < $end) {
483 if ($inLabel && $text[$i] === ']') {
484 $flush();
485 return ['tokens' => $tokens, 'next' => $i, 'stopped' => true];
486 }
487 if ($text[$i] === "\n") {
488 $flush();
489 $tokens[] = ['kind' => 'break'];
490 $i++;
491 continue;
492 }
493 if ($text[$i] === '\\' && $i + 1 < $end) {
494 $next = wikiCharAt($text, $i + 1, $end);
495 if (wikiEscapable($next)) {
496 $buffer .= $next;
497 $i += 1 + strlen($next);
498 continue;
499 }
500 }
501 if ($text[$i] === '`') {
502 $code = wikiTryCode($text, $i, $end);
503 if ($code) {
504 $flush();
505 $tokens[] = $code['token'];
506 $i = $code['next'];
507 continue;
301 }
508 }
302 $inlines[] = wikiRawLink($matches[1][$index][0]);
303 $offset = $start + strlen($full[0]);
304 }
509 }
510 if ($text[$i] === '[' && $i + 1 < $end && $text[$i + 1] === '[') {
511 $link = wikiTryWikiLink($text, $i, $end);
512 if ($link) {
513 $flush();
514 $tokens[] = ['kind' => 'wiki', 'link' => $link['link']];
515 $i = $link['next'];
516 continue;
517 }
518 }
519 if (!$inLabel && $text[$i] === '[') {
520 $link = wikiTryExternalLink($text, $i, $end);
521 if ($link) {
522 $flush();
523 $tokens[] = $link['token'];
524 $i = $link['next'];
525 continue;
526 }
527 }
528 if ($text[$i] === '*' || $text[$i] === '_') {
529 $marker = $text[$i];
530 $run = 0;
531 while ($i + $run < $end && $text[$i + $run] === $marker) $run++;
532 $before = wikiCharClass(wikiPrevChar($text, $i));
533 $after = wikiCharClass(wikiCharAt($text, $i + $run, $end));
534 $flush();
535 $tokens[] = [
536 'kind' => 'delim',
537 'marker' => $marker,
538 'len' => $run,
539 'canOpen' => wikiCanOpen($before, $after, $marker),
540 'canClose' => wikiCanClose($before, $after, $marker),
541 ];
542 $i += $run;
543 continue;
544 }
545 $char = wikiCharAt($text, $i, $end);
546 if ($char === '') { $i++; continue; }
547 $buffer .= $char;
548 $i += strlen($char);
305 }
549 }
306 if ($offset < strlen($text)) $inlines[] = ['type' => 'text', 'text' => substr($text, $offset)];
550 $flush();
551 return ['tokens' => $tokens, 'next' => $i, 'stopped' => false];
552}
553
554function wikiEscapable(string $char): bool {
555 return $char !== '' && str_contains('\\`*_{}[]()#+-.!|>', $char);
556}
557
558function wikiCharAt(string $text, int $byte, int $end): string {
559 if ($byte < 0 || $byte >= $end) return '';
560 $slice = substr($text, $byte, min(4, $end - $byte));
561 if (preg_match('/\A./us', $slice, $match) === 1) return $match[0];
562 return $text[$byte];
563}
564
565function wikiPrevChar(string $text, int $byte): string {
566 if ($byte <= 0) return '';
567 $start = max(0, $byte - 4);
568 $slice = substr($text, $start, $byte - $start);
569 if (preg_match('/.\z/us', $slice, $match) === 1) return $match[0];
570 return $text[$byte - 1];
571}
572
573function wikiCharClass(string $char): string {
574 if ($char === '') return 'edge';
575 if (preg_match('/\A\s\z/u', $char) === 1) return 'space';
576 if (preg_match('/\A[\p{L}\p{N}]\z/u', $char) === 1) return 'word';
577 return 'punct';
578}
579
580function wikiLeftFlanking(string $before, string $after): bool {
581 if ($after === 'space' || $after === 'edge') return false;
582 if ($after === 'punct' && $before !== 'space' && $before !== 'edge' && $before !== 'punct') return false;
583 return true;
584}
585
586function wikiRightFlanking(string $before, string $after): bool {
587 if ($before === 'space' || $before === 'edge') return false;
588 if ($before === 'punct' && $after !== 'space' && $after !== 'edge' && $after !== 'punct') return false;
589 return true;
590}
591
592function wikiCanOpen(string $before, string $after, string $marker): bool {
593 if (!wikiLeftFlanking($before, $after)) return false;
594 if ($marker === '_' && wikiRightFlanking($before, $after) && $before !== 'punct') return false;
595 return true;
596}
597
598function wikiCanClose(string $before, string $after, string $marker): bool {
599 if (!wikiRightFlanking($before, $after)) return false;
600 if ($marker === '_' && wikiLeftFlanking($before, $after) && $after !== 'punct') return false;
601 return true;
602}
603
604/** @return ?array{token:array<string,mixed>,next:int} */
605function wikiTryCode(string $text, int $i, int $end): ?array {
606 if ($text[$i] !== '`') return null;
607 $run = 0;
608 while ($i + $run < $end && $text[$i + $run] === '`') $run++;
609 $j = $i + $run;
610 while ($j < $end) {
611 if ($text[$j] !== '`') { $j++; continue; }
612 $close = 0;
613 while ($j + $close < $end && $text[$j + $close] === '`') $close++;
614 if ($close === $run) {
615 $content = substr($text, $i + $run, $j - ($i + $run));
616 $content = str_replace("\n", ' ', $content);
617 if (strlen($content) >= 2 && $content[0] === ' ' && str_ends_with($content, ' ') && trim($content) !== '') {
618 $content = substr($content, 1, -1);
619 }
620 return ['token' => ['kind' => 'code', 'text' => $content], 'next' => $j + $run];
621 }
622 $j += $close;
623 }
624 return null;
625}
626
627/** @return ?array{link:array<string,mixed>,next:int} */
628function wikiTryWikiLink(string $text, int $i, int $end): ?array {
629 if ($i + 3 >= $end || $text[$i] !== '[' || $text[$i + 1] !== '[') return null;
630 if (preg_match('/\A\[\[([^\[\]\n]+)\]\]/u', substr($text, $i, $end - $i), $match) !== 1) return null;
631 return ['link' => wikiRawLink($match[1]), 'next' => $i + strlen($match[0])];
632}
633
634/** @return ?array{token:array<string,mixed>,next:int} */
635function wikiTryExternalLink(string $text, int $i, int $end): ?array {
636 if ($text[$i] !== '[') return null;
637 $label = wikiScanInlines($text, $i + 1, $end, true);
638 if (!$label['stopped']) return null;
639 $j = $label['next'];
640 if ($j + 1 >= $end || $text[$j + 1] !== '(') return null;
641 $urlStart = $j + 2;
642 if ($urlStart >= $end) return null;
643 $url = '';
644 $next = $urlStart;
645 if ($text[$urlStart] === '<') {
646 $close = strpos($text, '>', $urlStart + 1);
647 if ($close === false || $close >= $end || $close + 1 >= $end || $text[$close + 1] !== ')') return null;
648 $url = substr($text, $urlStart + 1, $close - $urlStart - 1);
649 $next = $close + 2;
650 } else {
651 $depth = 0;
652 $k = $urlStart;
653 while ($k < $end) {
654 $char = wikiCharAt($text, $k, $end);
655 if ($char === '\\' && $k + strlen($char) < $end) {
656 $escaped = wikiCharAt($text, $k + 1, $end);
657 if (wikiEscapable($escaped)) {
658 $url .= $escaped;
659 $k += 1 + strlen($escaped);
660 continue;
661 }
662 }
663 if ($char === '(') { $depth++; $url .= '('; $k++; continue; }
664 if ($char === ')') {
665 if ($depth === 0) break;
666 $depth--;
667 $url .= ')';
668 $k++;
669 continue;
670 }
671 if (wikiCharClass($char) === 'space') return null;
672 $url .= $char;
673 $k += strlen($char);
674 }
675 if ($k >= $end || $text[$k] !== ')') return null;
676 $next = $k + 1;
677 }
678 $safe = wikiSafeUrl($url);
679 if ($safe === null) return null;
680 $children = $label['tokens'];
681 if (!$children) $children = [['kind' => 'text', 'text' => $safe]];
682 return ['token' => ['kind' => 'url', 'href' => $safe, 'children' => $children], 'next' => $next];
683}
684
685function wikiSafeUrl(string $url): ?string {
686 $url = trim($url);
687 if ($url === '' || strlen($url) > 2000) return null;
688 if (preg_match('/[\x00-\x20\x7F<>"\'\\\\]/', $url) === 1) return null;
689 if (preg_match('#\Ahttps?://[^\s/]+#i', $url) === 1) return $url;
690 if (preg_match('#\Amailto:[^@\s]+@[^@\s]+#i', $url) === 1) return $url;
691 return null;
692}
693
694/** @param list<array<string,mixed>> $tokens */
695function wikiMatchEmphasis(array $tokens): array {
696 $budget = count($tokens) + 1;
697 foreach ($tokens as $token) {
698 if (($token['kind'] ?? '') === 'delim') $budget += (int)($token['len'] ?? 0);
699 }
700 $guard = 0;
701 while ($guard++ < $budget) {
702 $found = wikiFirstEmphasisMatch($tokens);
703 if ($found === null) break;
704 [$open, $close, $use] = $found;
705 $inner = array_slice($tokens, $open + 1, $close - $open - 1);
706 $tokens[$open]['len'] -= $use;
707 $tokens[$close]['len'] -= $use;
708 $node = ['kind' => $use === 2 ? 'strong' : 'em', 'children' => $inner];
709 $replacement = [];
710 if ($tokens[$open]['len'] > 0) $replacement[] = $tokens[$open];
711 $replacement[] = $node;
712 if ($tokens[$close]['len'] > 0) $replacement[] = $tokens[$close];
713 array_splice($tokens, $open, $close - $open + 1, $replacement);
714 }
715 return wikiTokensToInlines($tokens);
716}
717
718/** @param list<array<string,mixed>> $tokens
719 * @return ?array{0:int,1:int,2:int}
720 */
721function wikiFirstEmphasisMatch(array $tokens): ?array {
722 $count = count($tokens);
723 for ($close = 0; $close < $count; $close++) {
724 $closer = $tokens[$close];
725 if (($closer['kind'] ?? '') !== 'delim' || empty($closer['canClose']) || (int)$closer['len'] < 1) continue;
726 for ($open = $close - 1; $open >= 0; $open--) {
727 $opener = $tokens[$open];
728 if (($opener['kind'] ?? '') !== 'delim' || empty($opener['canOpen']) || (int)$opener['len'] < 1) continue;
729 if ($opener['marker'] !== $closer['marker']) continue;
730 if (!wikiDelimLengthsOk((int)$opener['len'], (int)$closer['len'])) continue;
731 $use = ((int)$opener['len'] >= 2 && (int)$closer['len'] >= 2) ? 2 : 1;
732 return [$open, $close, $use];
733 }
734 }
735 return null;
736}
737
738function wikiDelimLengthsOk(int $opener, int $closer): bool {
739 if ($opener < 1 || $closer < 1) return false;
740 if (($opener % 3 === 0 || $closer % 3 === 0) && (($opener + $closer) % 3 !== 0)) return false;
741 return true;
742}
743
744/** @param list<array<string,mixed>> $tokens
745 * @return list<array<string,mixed>>
746 */
747function wikiTokensToInlines(array $tokens): array {
748 $inlines = [];
749 $buffer = '';
750 $flush = function () use (&$inlines, &$buffer): void {
751 if ($buffer !== '') {
752 $inlines[] = ['type' => 'text', 'text' => $buffer];
753 $buffer = '';
754 }
755 };
756 foreach ($tokens as $token) {
757 $kind = $token['kind'] ?? '';
758 if ($kind === 'text') { $buffer .= $token['text']; continue; }
759 if ($kind === 'delim') {
760 $length = (int)($token['len'] ?? 0);
761 if ($length > 0) $buffer .= str_repeat((string)$token['marker'], $length);
762 continue;
763 }
764 $flush();
765 if ($kind === 'break') { $inlines[] = ['type' => 'break']; continue; }
766 if ($kind === 'code') { $inlines[] = ['type' => 'code', 'text' => (string)($token['text'] ?? '')]; continue; }
767 if ($kind === 'wiki') { $inlines[] = $token['link']; continue; }
768 if ($kind === 'url') {
769 $children = wikiMatchEmphasis($token['children'] ?? []);
770 if (!$children) $children = [['type' => 'text', 'text' => (string)$token['href']]];
771 $inlines[] = ['type' => 'url', 'href' => (string)$token['href'], 'inlines' => $children];
772 continue;
773 }
774 if ($kind === 'strong' || $kind === 'em') {
775 $inlines[] = ['type' => $kind, 'inlines' => wikiTokensToInlines($token['children'] ?? [])];
776 }
777 }
778 $flush();
307 return $inlines;
779 return $inlines;
308}
780}
309
781
@@ -388,27 +860,86 @@ function wikiResolveLink(array $link, string $pageSlug, array $catalog): array {
388function wikiResolveChapters(array $chapters, string $pageSlug, array $catalog): array {
860function wikiResolveChapters(array $chapters, string $pageSlug, array $catalog): array {
389 $resolved = [];
861 $resolved = [];
390 foreach ($chapters as $chapter) {
862 foreach ($chapters as $chapter) {
391 $blocks = [];
392 foreach ($chapter['blocks'] as $block) {
393 $inlines = [];
394 foreach ($block['inlines'] as $inline) {
395 if (($inline['type'] ?? '') === 'text') {
396 if (($inline['text'] ?? '') !== '') $inlines[] = ['type' => 'text', 'text' => $inline['text']];
397 continue;
398 }
399 $inlines[] = wikiResolveLink($inline, $pageSlug, $catalog);
400 }
401 if ($inlines) $blocks[] = ['inlines' => $inlines];
402 }
403 $resolved[] = [
863 $resolved[] = [
404 'anchor' => $chapter['anchor'],
864 'anchor' => $chapter['anchor'],
405 'title' => $chapter['title'],
865 'title' => $chapter['title'],
406 'blocks' => $blocks,
866 'blocks' => wikiResolveBlocks($chapter['blocks'], $pageSlug, $catalog),
407 ];
867 ];
408 }
868 }
409 return $resolved;
869 return $resolved;
410}
870}
411
871
872/** @param list<array<string,mixed>> $blocks
873 * @return list<array<string,mixed>>
874 */
875function wikiResolveBlocks(array $blocks, string $pageSlug, array $catalog): array {
876 $resolved = [];
877 foreach ($blocks as $block) {
878 $type = $block['type'] ?? 'paragraph';
879 if ($type === 'list') {
880 $items = [];
881 foreach ($block['items'] ?? [] as $item) {
882 $items[] = ['blocks' => wikiResolveBlocks($item['blocks'] ?? [], $pageSlug, $catalog)];
883 }
884 $copy = ['type' => 'list', 'ordered' => (bool)($block['ordered'] ?? false), 'items' => $items];
885 if (isset($block['start'])) $copy['start'] = (int)$block['start'];
886 $resolved[] = $copy;
887 continue;
888 }
889 if ($type === 'quote') {
890 $inner = wikiResolveBlocks($block['blocks'] ?? [], $pageSlug, $catalog);
891 if ($inner) $resolved[] = ['type' => 'quote', 'blocks' => $inner];
892 continue;
893 }
894 $inlines = wikiResolveInlines($block['inlines'] ?? [], $pageSlug, $catalog, false);
895 if ($inlines) $resolved[] = ['type' => 'paragraph', 'inlines' => $inlines];
896 }
897 return $resolved;
898}
899
900/** @param list<array<string,mixed>> $inlines
901 * @return list<array<string,mixed>>
902 */
903function wikiResolveInlines(array $inlines, string $pageSlug, array $catalog, bool $insideUrl): array {
904 $resolved = [];
905 foreach ($inlines as $inline) {
906 $type = $inline['type'] ?? '';
907 if ($type === 'text') {
908 if (($inline['text'] ?? '') !== '') $resolved[] = ['type' => 'text', 'text' => $inline['text']];
909 continue;
910 }
911 if ($type === 'break') { $resolved[] = ['type' => 'break']; continue; }
912 if ($type === 'code') { $resolved[] = ['type' => 'code', 'text' => (string)($inline['text'] ?? '')]; continue; }
913 if ($type === 'link') {
914 $link = wikiResolveLink($inline, $pageSlug, $catalog);
915 if ($insideUrl) {
916 if ($link['text'] !== '') $resolved[] = ['type' => 'text', 'text' => $link['text']];
917 continue;
918 }
919 $resolved[] = $link;
920 continue;
921 }
922 if ($type === 'strong' || $type === 'em') {
923 $resolved[] = [
924 'type' => $type,
925 'inlines' => wikiResolveInlines($inline['inlines'] ?? [], $pageSlug, $catalog, $insideUrl),
926 ];
927 continue;
928 }
929 if ($type === 'url') {
930 $href = wikiSafeUrl((string)($inline['href'] ?? ''));
931 if ($href === null) {
932 foreach (wikiResolveInlines($inline['inlines'] ?? [], $pageSlug, $catalog, true) as $child) $resolved[] = $child;
933 continue;
934 }
935 $children = wikiResolveInlines($inline['inlines'] ?? [], $pageSlug, $catalog, true);
936 if (!$children) $children = [['type' => 'text', 'text' => $href]];
937 $resolved[] = ['type' => 'url', 'href' => $href, 'inlines' => $children];
938 }
939 }
940 return $resolved;
941}
942
412function loadWikiPage(string $slug): array {
943function loadWikiPage(string $slug): array {
413 $page = wikiPageRow($slug);
944 $page = wikiPageRow($slug);
414 $category = query('SELECT slug, title FROM wiki_categories WHERE id=?', [$page['category_id']])->fetch();
945 $category = query('SELECT slug, title FROM wiki_categories WHERE id=?', [$page['category_id']])->fetch();
web/lib/bootstrap.php +4 −4
@@ -200,16 +200,16 @@ function authPublicBase(): string {
200 200
201 201 function authHint(string $kind): string {
202 202 $base = authPublicBase();
203 $keys = ($base !== '' ? $base : '').'/#/sleutels';
203 $beheer = ($base !== '' ? $base : '').'/#/beheer';
204 204 $docs = ($base !== '' ? $base.'/' : '').'docs.php';
205 $how = 'Stuur de header Authorization: Bearer vb_… met een API-sleutel. Een beheerder maakt sleutels aan onder Sleutels op '.$keys.'. Uitleg: '.$docs;
205 $how = 'Stuur de header Authorization: Bearer vb_… met een API-sleutel. Een beheerder maakt sleutels aan onder Beheer op '.$beheer.'. Uitleg: '.$docs;
206 206 return match ($kind) {
207 207 'missing' => 'Er is geen Authorization-header. '.$how,
208 208 'format' => 'De Authorization-header heeft het verkeerde formaat. Gebruik Bearer, gevolgd door vb_ en 64 hexadecimale tekens. '.$how,
209 209 'rejected' => 'Deze API-sleutel is onbekend of ingetrokken. '.$how,
210 210 'writer' => 'Dit mag alleen met een API-sleutel of als beheerder. '.$how,
211 'admin' => 'Sleutels beheren kan alleen als ingelogde beheerder, niet met een API-sleutel. Open Sleutels op '.$keys.'. Uitleg: '.$docs,
212 'users' => 'Gebruikers beheren kan alleen als ingelogde beheerder, niet met een API-sleutel. Open Beheer op '.($base !== '' ? $base : '').'/#/beheer. Uitleg: '.$docs,
211 'admin' => 'Sleutels beheren kan alleen als ingelogde beheerder, niet met een API-sleutel. Open Beheer op '.$beheer.'. Uitleg: '.$docs,
212 'users' => 'Gebruikers beheren kan alleen als ingelogde beheerder, niet met een API-sleutel. Open Beheer op '.$beheer.'. Uitleg: '.$docs,
213 213 default => $how,
214 214 };
215 215 }
@@ -200,16 +200,16 @@ function authPublicBase(): string {
200
200
201function authHint(string $kind): string {
201function authHint(string $kind): string {
202 $base = authPublicBase();
202 $base = authPublicBase();
203 $keys = ($base !== '' ? $base : '').'/#/sleutels';
203 $beheer = ($base !== '' ? $base : '').'/#/beheer';
204 $docs = ($base !== '' ? $base.'/' : '').'docs.php';
204 $docs = ($base !== '' ? $base.'/' : '').'docs.php';
205 $how = 'Stuur de header Authorization: Bearer vb_… met een API-sleutel. Een beheerder maakt sleutels aan onder Sleutels op '.$keys.'. Uitleg: '.$docs;
205 $how = 'Stuur de header Authorization: Bearer vb_… met een API-sleutel. Een beheerder maakt sleutels aan onder Beheer op '.$beheer.'. Uitleg: '.$docs;
206 return match ($kind) {
206 return match ($kind) {
207 'missing' => 'Er is geen Authorization-header. '.$how,
207 'missing' => 'Er is geen Authorization-header. '.$how,
208 'format' => 'De Authorization-header heeft het verkeerde formaat. Gebruik Bearer, gevolgd door vb_ en 64 hexadecimale tekens. '.$how,
208 'format' => 'De Authorization-header heeft het verkeerde formaat. Gebruik Bearer, gevolgd door vb_ en 64 hexadecimale tekens. '.$how,
209 'rejected' => 'Deze API-sleutel is onbekend of ingetrokken. '.$how,
209 'rejected' => 'Deze API-sleutel is onbekend of ingetrokken. '.$how,
210 'writer' => 'Dit mag alleen met een API-sleutel of als beheerder. '.$how,
210 'writer' => 'Dit mag alleen met een API-sleutel of als beheerder. '.$how,
211 'admin' => 'Sleutels beheren kan alleen als ingelogde beheerder, niet met een API-sleutel. Open Sleutels op '.$keys.'. Uitleg: '.$docs,
211 'admin' => 'Sleutels beheren kan alleen als ingelogde beheerder, niet met een API-sleutel. Open Beheer op '.$beheer.'. Uitleg: '.$docs,
212 'users' => 'Gebruikers beheren kan alleen als ingelogde beheerder, niet met een API-sleutel. Open Beheer op '.($base !== '' ? $base : '').'/#/beheer. Uitleg: '.$docs,
212 'users' => 'Gebruikers beheren kan alleen als ingelogde beheerder, niet met een API-sleutel. Open Beheer op '.$beheer.'. Uitleg: '.$docs,
213 default => $how,
213 default => $how,
214 };
214 };
215}
215}
web/sw.js +1 −1
@@ -3,7 +3,7 @@
3 3 // Shell-cache voor offline lezen. API, wiki-schrijfacties, inloggen en andere
4 4 // schrijfacties gaan altijd naar het netwerk. Wiki leest en schrijft via api.php
5 5 // (Bearer of sessie); die paden worden hieronder overgeslagen en nooit gecachet.
6 const CACHE = 'verhalenboek-v2';
6 const CACHE = 'verhalenboek-v3';
7 7 const PRECACHE = [
8 8 'assets/favicon.svg',
9 9 'assets/favicon-32.png',
@@ -3,7 +3,7 @@
3// Shell-cache voor offline lezen. API, wiki-schrijfacties, inloggen en andere
3// Shell-cache voor offline lezen. API, wiki-schrijfacties, inloggen en andere
4// schrijfacties gaan altijd naar het netwerk. Wiki leest en schrijft via api.php
4// schrijfacties gaan altijd naar het netwerk. Wiki leest en schrijft via api.php
5// (Bearer of sessie); die paden worden hieronder overgeslagen en nooit gecachet.
5// (Bearer of sessie); die paden worden hieronder overgeslagen en nooit gecachet.
6const CACHE = 'verhalenboek-v2';
6const CACHE = 'verhalenboek-v3';
7const PRECACHE = [
7const PRECACHE = [
8 'assets/favicon.svg',
8 'assets/favicon.svg',
9 'assets/favicon-32.png',
9 'assets/favicon-32.png',
web/tests/integration.py +22 −0
@@ -298,6 +298,7 @@ with tempfile.TemporaryDirectory(prefix='api-', dir=ARTIFACTS) as tmp:
298 298 empty_admin = page_html(admin)
299 299 check('data-nav="/wiki"' not in empty_reader and 'Instellingen' in empty_reader, 'Een lezer ziet geen wiki-tabblad zolang er geen pagina is')
300 300 check(empty_admin.index('>Overzicht<') < empty_admin.index('>Wiki<') < empty_admin.index('>Instellingen<'), 'Een beheerder ziet de wiki ook als die leeg is')
301 check('data-nav="/beheer"' in empty_admin and 'data-nav="/sleutels"' not in empty_admin and '>Sleutels<' not in empty_admin, 'Sleutels is geen apart tabblad meer')
301 302 check(reader.me()['wiki'] is False and admin.me()['wiki'] is True, 'GET /me zegt of deze gebruiker de wiki ziet')
302 303 check(reader.request('GET', '/wiki/categories') == {'categories': []}, 'Een lezer mag de wiki lezen')
303 304 reader_wiki = reader.request('POST', '/wiki/categories', {'title': 'Verboden'}, expected=403)
@@ -342,6 +343,24 @@ with tempfile.TemporaryDirectory(prefix='api-', dir=ARTIFACTS) as tmp:
342 343 links = [part for block in bas['chapters'][0]['blocks'] for part in block['inlines'] if part['type'] == 'link']
343 344 check(links[0]['page'] == 'oude-plein' and links[0]['anchor'] is None and links[0]['text'] == 'oude plein' and links[0]['broken'] is False, 'Link naar een andere pagina')
344 345 check(links[1]['page'] == 'speelgoedkist' and links[1]['anchor'] == 'deksel' and links[1]['broken'] is False, 'Link naar een hoofdstuk op een andere pagina')
346 opmaak = bearer.request('POST', '/wiki/pages', {
347 'title': 'Opmaak',
348 'slug': 'opmaak',
349 'category': 'plekken',
350 'content': 'Inleiding.\n\n## Lijst\n\n- **vet** en [[oude-plein|plein]]\n - *cursief*\n\nZie [site](https://example.com).\n\nNiet [x](javascript:alert(1)).',
351 }, expected=201)
352 check([chapter['anchor'] for chapter in opmaak['chapters']] == ['inleiding', 'lijst'], 'Markdown laat de hoofdstukken staan')
353 md_list = opmaak['chapters'][1]['blocks'][0]
354 check(md_list['type'] == 'list' and md_list['ordered'] is False and len(md_list['items']) == 1, 'Markdownlijst via de API')
355 first = md_list['items'][0]['blocks'][0]['inlines']
356 check(first[0]['type'] == 'strong' and first[0]['inlines'][0]['text'] == 'vet', 'Vet in een lijstpunt')
357 check(first[2]['type'] == 'link' and first[2]['page'] == 'oude-plein' and first[2]['broken'] is False and first[2]['text'] == 'plein', 'Verwijzing in een lijstpunt')
358 nested = md_list['items'][0]['blocks'][1]
359 check(nested['type'] == 'list' and nested['items'][0]['blocks'][0]['inlines'][0]['type'] == 'em', 'Geneste cursieve lijst')
360 site = opmaak['chapters'][1]['blocks'][1]['inlines'][1]
361 check(site['type'] == 'url' and site['href'] == 'https://example.com' and site['inlines'][0]['text'] == 'site', 'Externe link')
362 unsafe = opmaak['chapters'][1]['blocks'][2]['inlines'][0]['text']
363 check('javascript:alert(1)' in unsafe and all(part['type'] != 'url' for part in opmaak['chapters'][1]['blocks'][2]['inlines']), 'Een javascript-url wordt geen link')
345 364 check(bearer.request('GET', '/wiki/pages/bas')['title'] == 'Bas', 'Een pagina ophalen op slug')
346 365 found = bearer.request('GET', '/wiki/pages?q=deksel&category=speeltjes')['pages']
347 366 check([page['slug'] for page in found] == ['speelgoedkist'] and 'content' not in found[0], 'Zoeken in de tekst, gefilterd op categorie, zonder de lopende tekst')
@@ -353,6 +372,7 @@ with tempfile.TemporaryDirectory(prefix='api-', dir=ARTIFACTS) as tmp:
353 372 reader.request('PUT', '/wiki/pages/bas', {'title': 'Nee'}, expected=403)
354 373 bearer.request('DELETE', '/wiki/categories/vriendjes', expected=409)
355 374 check(bearer.request('DELETE', '/wiki/pages/bas') == {'ok': True, 'slug': 'bas'}, 'Pagina verwijderen')
375 check(bearer.request('DELETE', '/wiki/pages/opmaak') == {'ok': True, 'slug': 'opmaak'}, 'Opmaakpagina verwijderen')
356 376 check(bearer.request('DELETE', '/wiki/categories/vriendjes') == {'ok': True, 'slug': 'vriendjes'}, 'Lege categorie verwijderen')
357 377 bearer.request('GET', '/wiki/pages/bas', expected=404)
358 378 bearer.request('PUT', '/wiki/categories', {'title': 'Nee'}, expected=405)
@@ -387,6 +407,8 @@ with tempfile.TemporaryDirectory(prefix='api-', dir=ARTIFACTS) as tmp:
387 407 body = docs.read().decode()
388 408 check(docs.status == 200 and 'precies drie verhalen' in body and 'days/latest' in body and 'how_to_authenticate' in body and 'WWW-Authenticate' in body, 'API-documentatie legt authenticatie uit')
389 409 check('[[pagina-slug#hoofdstuk|tekst]]' in body and '/wiki/pages' in body and 'inleiding' in body and 'broken' in body and 'minstens één pagina' in body, 'API-documentatie legt de wiki, de verwijzingen en het tabblad uit')
410 check('Ongeordende lijst' in body and '**vet**' in body and 'rel="noopener"' in body and 'mailto' in body, 'API-documentatie legt Markdown uit')
411 check('#/sleutels' not in body and '#/beheer' in body and 'onderaan Beheer' in body, 'API-documentatie wijst sleutels naar Beheer')
390 412
391 413 auth_bootstrap = root / 'lib/bootstrap.php'
392 414 auth_bootstrap.write_text(auth_bootstrap.read_text().replace(
@@ -298,6 +298,7 @@ with tempfile.TemporaryDirectory(prefix='api-', dir=ARTIFACTS) as tmp:
298 empty_admin = page_html(admin)
298 empty_admin = page_html(admin)
299 check('data-nav="/wiki"' not in empty_reader and 'Instellingen' in empty_reader, 'Een lezer ziet geen wiki-tabblad zolang er geen pagina is')
299 check('data-nav="/wiki"' not in empty_reader and 'Instellingen' in empty_reader, 'Een lezer ziet geen wiki-tabblad zolang er geen pagina is')
300 check(empty_admin.index('>Overzicht<') < empty_admin.index('>Wiki<') < empty_admin.index('>Instellingen<'), 'Een beheerder ziet de wiki ook als die leeg is')
300 check(empty_admin.index('>Overzicht<') < empty_admin.index('>Wiki<') < empty_admin.index('>Instellingen<'), 'Een beheerder ziet de wiki ook als die leeg is')
301 check('data-nav="/beheer"' in empty_admin and 'data-nav="/sleutels"' not in empty_admin and '>Sleutels<' not in empty_admin, 'Sleutels is geen apart tabblad meer')
301 check(reader.me()['wiki'] is False and admin.me()['wiki'] is True, 'GET /me zegt of deze gebruiker de wiki ziet')
302 check(reader.me()['wiki'] is False and admin.me()['wiki'] is True, 'GET /me zegt of deze gebruiker de wiki ziet')
302 check(reader.request('GET', '/wiki/categories') == {'categories': []}, 'Een lezer mag de wiki lezen')
303 check(reader.request('GET', '/wiki/categories') == {'categories': []}, 'Een lezer mag de wiki lezen')
303 reader_wiki = reader.request('POST', '/wiki/categories', {'title': 'Verboden'}, expected=403)
304 reader_wiki = reader.request('POST', '/wiki/categories', {'title': 'Verboden'}, expected=403)
@@ -342,6 +343,24 @@ with tempfile.TemporaryDirectory(prefix='api-', dir=ARTIFACTS) as tmp:
342 links = [part for block in bas['chapters'][0]['blocks'] for part in block['inlines'] if part['type'] == 'link']
343 links = [part for block in bas['chapters'][0]['blocks'] for part in block['inlines'] if part['type'] == 'link']
343 check(links[0]['page'] == 'oude-plein' and links[0]['anchor'] is None and links[0]['text'] == 'oude plein' and links[0]['broken'] is False, 'Link naar een andere pagina')
344 check(links[0]['page'] == 'oude-plein' and links[0]['anchor'] is None and links[0]['text'] == 'oude plein' and links[0]['broken'] is False, 'Link naar een andere pagina')
344 check(links[1]['page'] == 'speelgoedkist' and links[1]['anchor'] == 'deksel' and links[1]['broken'] is False, 'Link naar een hoofdstuk op een andere pagina')
345 check(links[1]['page'] == 'speelgoedkist' and links[1]['anchor'] == 'deksel' and links[1]['broken'] is False, 'Link naar een hoofdstuk op een andere pagina')
346 opmaak = bearer.request('POST', '/wiki/pages', {
347 'title': 'Opmaak',
348 'slug': 'opmaak',
349 'category': 'plekken',
350 'content': 'Inleiding.\n\n## Lijst\n\n- **vet** en [[oude-plein|plein]]\n - *cursief*\n\nZie [site](https://example.com).\n\nNiet [x](javascript:alert(1)).',
351 }, expected=201)
352 check([chapter['anchor'] for chapter in opmaak['chapters']] == ['inleiding', 'lijst'], 'Markdown laat de hoofdstukken staan')
353 md_list = opmaak['chapters'][1]['blocks'][0]
354 check(md_list['type'] == 'list' and md_list['ordered'] is False and len(md_list['items']) == 1, 'Markdownlijst via de API')
355 first = md_list['items'][0]['blocks'][0]['inlines']
356 check(first[0]['type'] == 'strong' and first[0]['inlines'][0]['text'] == 'vet', 'Vet in een lijstpunt')
357 check(first[2]['type'] == 'link' and first[2]['page'] == 'oude-plein' and first[2]['broken'] is False and first[2]['text'] == 'plein', 'Verwijzing in een lijstpunt')
358 nested = md_list['items'][0]['blocks'][1]
359 check(nested['type'] == 'list' and nested['items'][0]['blocks'][0]['inlines'][0]['type'] == 'em', 'Geneste cursieve lijst')
360 site = opmaak['chapters'][1]['blocks'][1]['inlines'][1]
361 check(site['type'] == 'url' and site['href'] == 'https://example.com' and site['inlines'][0]['text'] == 'site', 'Externe link')
362 unsafe = opmaak['chapters'][1]['blocks'][2]['inlines'][0]['text']
363 check('javascript:alert(1)' in unsafe and all(part['type'] != 'url' for part in opmaak['chapters'][1]['blocks'][2]['inlines']), 'Een javascript-url wordt geen link')
345 check(bearer.request('GET', '/wiki/pages/bas')['title'] == 'Bas', 'Een pagina ophalen op slug')
364 check(bearer.request('GET', '/wiki/pages/bas')['title'] == 'Bas', 'Een pagina ophalen op slug')
346 found = bearer.request('GET', '/wiki/pages?q=deksel&category=speeltjes')['pages']
365 found = bearer.request('GET', '/wiki/pages?q=deksel&category=speeltjes')['pages']
347 check([page['slug'] for page in found] == ['speelgoedkist'] and 'content' not in found[0], 'Zoeken in de tekst, gefilterd op categorie, zonder de lopende tekst')
366 check([page['slug'] for page in found] == ['speelgoedkist'] and 'content' not in found[0], 'Zoeken in de tekst, gefilterd op categorie, zonder de lopende tekst')
@@ -353,6 +372,7 @@ with tempfile.TemporaryDirectory(prefix='api-', dir=ARTIFACTS) as tmp:
353 reader.request('PUT', '/wiki/pages/bas', {'title': 'Nee'}, expected=403)
372 reader.request('PUT', '/wiki/pages/bas', {'title': 'Nee'}, expected=403)
354 bearer.request('DELETE', '/wiki/categories/vriendjes', expected=409)
373 bearer.request('DELETE', '/wiki/categories/vriendjes', expected=409)
355 check(bearer.request('DELETE', '/wiki/pages/bas') == {'ok': True, 'slug': 'bas'}, 'Pagina verwijderen')
374 check(bearer.request('DELETE', '/wiki/pages/bas') == {'ok': True, 'slug': 'bas'}, 'Pagina verwijderen')
375 check(bearer.request('DELETE', '/wiki/pages/opmaak') == {'ok': True, 'slug': 'opmaak'}, 'Opmaakpagina verwijderen')
356 check(bearer.request('DELETE', '/wiki/categories/vriendjes') == {'ok': True, 'slug': 'vriendjes'}, 'Lege categorie verwijderen')
376 check(bearer.request('DELETE', '/wiki/categories/vriendjes') == {'ok': True, 'slug': 'vriendjes'}, 'Lege categorie verwijderen')
357 bearer.request('GET', '/wiki/pages/bas', expected=404)
377 bearer.request('GET', '/wiki/pages/bas', expected=404)
358 bearer.request('PUT', '/wiki/categories', {'title': 'Nee'}, expected=405)
378 bearer.request('PUT', '/wiki/categories', {'title': 'Nee'}, expected=405)
@@ -387,6 +407,8 @@ with tempfile.TemporaryDirectory(prefix='api-', dir=ARTIFACTS) as tmp:
387 body = docs.read().decode()
407 body = docs.read().decode()
388 check(docs.status == 200 and 'precies drie verhalen' in body and 'days/latest' in body and 'how_to_authenticate' in body and 'WWW-Authenticate' in body, 'API-documentatie legt authenticatie uit')
408 check(docs.status == 200 and 'precies drie verhalen' in body and 'days/latest' in body and 'how_to_authenticate' in body and 'WWW-Authenticate' in body, 'API-documentatie legt authenticatie uit')
389 check('[[pagina-slug#hoofdstuk|tekst]]' in body and '/wiki/pages' in body and 'inleiding' in body and 'broken' in body and 'minstens één pagina' in body, 'API-documentatie legt de wiki, de verwijzingen en het tabblad uit')
409 check('[[pagina-slug#hoofdstuk|tekst]]' in body and '/wiki/pages' in body and 'inleiding' in body and 'broken' in body and 'minstens één pagina' in body, 'API-documentatie legt de wiki, de verwijzingen en het tabblad uit')
410 check('Ongeordende lijst' in body and '**vet**' in body and 'rel="noopener"' in body and 'mailto' in body, 'API-documentatie legt Markdown uit')
411 check('#/sleutels' not in body and '#/beheer' in body and 'onderaan Beheer' in body, 'API-documentatie wijst sleutels naar Beheer')
390
412
391 auth_bootstrap = root / 'lib/bootstrap.php'
413 auth_bootstrap = root / 'lib/bootstrap.php'
392 auth_bootstrap.write_text(auth_bootstrap.read_text().replace(
414 auth_bootstrap.write_text(auth_bootstrap.read_text().replace(
web/tests/storybook.php +113 −8
@@ -25,13 +25,22 @@ function rejects(callable $fn, int $status, string $label): void {
25 25 }
26 26 function wikiLinks(array $page): array {
27 27 $links = [];
28 foreach ($page['chapters'] as $chapter) {
29 foreach ($chapter['blocks'] as $block) {
30 foreach ($block['inlines'] as $inline) {
31 if (($inline['type'] ?? '') === 'link') $links[] = $inline;
28 $walkInlines = function (array $inlines) use (&$walkInlines, &$links): void {
29 foreach ($inlines as $inline) {
30 if (($inline['type'] ?? '') === 'link') $links[] = $inline;
31 if (isset($inline['inlines']) && is_array($inline['inlines'])) $walkInlines($inline['inlines']);
32 }
33 };
34 $walkBlocks = function (array $blocks) use (&$walkBlocks, $walkInlines): void {
35 foreach ($blocks as $block) {
36 if (isset($block['inlines']) && is_array($block['inlines'])) $walkInlines($block['inlines']);
37 if (($block['type'] ?? '') === 'list') {
38 foreach ($block['items'] ?? [] as $item) $walkBlocks($item['blocks'] ?? []);
32 39 }
40 if (($block['type'] ?? '') === 'quote') $walkBlocks($block['blocks'] ?? []);
33 41 }
34 }
42 };
43 foreach ($page['chapters'] as $chapter) $walkBlocks($chapter['blocks']);
35 44 return $links;
36 45 }
37 46 function three(string $prefix = 'Verhaal'): array {
@@ -156,7 +165,8 @@ check($export['api_keys'][0]['prefix'] === $key['prefix'] && $export['api_keys']
156 165 $secret = config()['key_secret'] ?? '';
157 166 check(is_string($secret) && preg_match('/^[a-f0-9]{64}$/', $secret) === 1, 'key_secret wordt automatisch aangemaakt');
158 167 file_put_contents($root.'/config.php', str_replace("'base_url' => ''", "'base_url' => 'https://projects.timfalken.com/verhaaltjesboek'", (string)file_get_contents($root.'/config.php')));
159 check(str_contains(authHint('missing'), 'geen Authorization-header') && str_contains(authHint('missing'), 'https://projects.timfalken.com/verhaaltjesboek/docs.php'), 'Ontbrekende header legt uit waar de sleutel vandaan komt');
168 check(str_contains(authHint('missing'), 'geen Authorization-header') && str_contains(authHint('missing'), 'https://projects.timfalken.com/verhaaltjesboek/docs.php') && str_contains(authHint('missing'), '/#/beheer') && !str_contains(authHint('missing'), '/#/sleutels'), 'Ontbrekende header wijst naar Beheer');
169 check(str_contains(authHint('admin'), 'Open Beheer op https://projects.timfalken.com/verhaaltjesboek/#/beheer') && !str_contains(authHint('admin'), '/#/sleutels'), 'Sleutelbeheer wijst naar Beheer');
160 170 check(str_contains(authHint('format'), 'verkeerde formaat') && str_contains(authHint('rejected'), 'onbekend of ingetrokken') && str_contains(authHint('writer'), 'API-sleutel of als beheerder'), 'De uitleg onderscheidt formaat, afwijzing en rechten');
161 171
162 172 check(weekBounds('2026-10-05') === [
@@ -324,7 +334,7 @@ $plein = createWikiPage([
324 334 check(array_column($plein['chapters'], 'anchor') === ['inleiding', 'de-boom', 'de-bank'], 'Inleiding en hoofdstukken krijgen stabiele ankers');
325 335 check($plein['chapters'][0]['title'] === null && $plein['chapters'][1]['title'] === 'De boom', 'De inleiding heeft geen eigen titel');
326 336 check(wikiHasPages() === true && wikiVisible(false) === true, 'Met een pagina ziet ook een lezer de wiki');
327 check($plein['chapters'][0]['blocks'][0]['inlines'][0]['text'] === 'Achter de huizen.', 'Tekst vóór het eerste hoofdstuk blijft een alinea');
337 check($plein['chapters'][0]['blocks'][0]['type'] === 'paragraph' && $plein['chapters'][0]['blocks'][0]['inlines'][0]['text'] === 'Achter de huizen.', 'Tekst vóór het eerste hoofdstuk blijft een alinea');
328 338 $terug = wikiLinks($plein)[0];
329 339 check($terug['broken'] === false && $terug['page'] === 'oude-plein' && $terug['anchor'] === 'inleiding' && $terug['text'] === 'terug', 'Verwijzing naar een hoofdstuk op dezelfde pagina');
330 340
@@ -401,8 +411,103 @@ rejects(fn() => loadWikiPage('oude-plein'), 404, 'De oude slug bestaat niet meer
401 411 $brokenPage = wikiLinks(loadWikiPage('bas'))[0];
402 412 check($brokenPage['text'] === 'oude plein' && $brokenPage['broken'] === true, 'Een verwijzing naar de oude slug wordt zichtbaar kapot');
403 413
414 $opmaak = createWikiPage([
415 'title' => 'Opmaak',
416 'slug' => 'opmaak',
417 'category' => 'plekken',
418 'content' => implode("\n", [
419 'Inleiding met een',
420 'zachte regel.',
421 '',
422 '# geen hoofdstuk',
423 '',
424 '## De lijst',
425 '',
426 '- appel **rood**',
427 '- [[bas|Bas]] en [[#de-lijst|hier]]',
428 ' - genest met *cursief*',
429 '- derde',
430 '',
431 '1. een',
432 '2. twee',
433 '',
434 'Tekst ertussen.',
435 '',
436 '3. vanaf drie',
437 '',
438 'Een regel ',
439 'met harde breuk.',
440 '',
441 'Regel\\',
442 'met backslash.',
443 '',
444 '> Een citaat met [[bas]] en `[[geen-code]]`.',
445 '',
446 'Zie [de site](https://example.com/pad) en [mail](mailto:bas@example.com).',
447 'Niet [xss](javascript:alert(1)) en niet [data](data:text/html,x) en niet [rel](//example.com) en niet [groot](JAVASCRIPT:alert(1)).',
448 '',
449 'foo_bar_baz blijft *wel* cursief en __vet__ en ***beide*** en _ook_.',
450 '',
451 '**zie [[bas]] in vet**',
452 '',
453 'Zie [[bas|',
454 'Bas]] morgen.',
455 '',
456 '<script>alert(1)</script>',
457 '',
458 '- <b>geen html</b> en [veilig](HTTPS://example.com/Pad)',
459 ' 1. genest nummer',
460 '',
461 'a * b * c en een *ster',
462 '',
463 '\*niet\*',
464 '',
465 '## Samen',
466 '',
467 'Klaar.',
468 ]),
469 ]);
470 check(array_column($opmaak['chapters'], 'anchor') === ['inleiding', 'de-lijst', 'samen'], 'Markdown verandert de hoofdstukken en ankers niet');
471 check($opmaak['chapters'][0]['blocks'][0]['inlines'] === [['type' => 'text', 'text' => 'Inleiding met een zachte regel.']], 'Een zacht regeleinde blijft een spatie');
472 check($opmaak['chapters'][0]['blocks'][1]['inlines'][0]['text'] === '# geen hoofdstuk', 'Een hekje zonder twee hekjes blijft tekst');
473 $lijst = $opmaak['chapters'][1]['blocks'];
474 check($lijst[0]['type'] === 'list' && $lijst[0]['ordered'] === false && count($lijst[0]['items']) === 3, 'Ongeordende lijst');
475 check($lijst[0]['items'][0]['blocks'][0]['inlines'][0] === ['type' => 'text', 'text' => 'appel '] && $lijst[0]['items'][0]['blocks'][0]['inlines'][1]['type'] === 'strong' && $lijst[0]['items'][0]['blocks'][0]['inlines'][1]['inlines'] === [['type' => 'text', 'text' => 'rood']], 'Vet in een lijstpunt');
476 $tweede = $lijst[0]['items'][1];
477 check($tweede['blocks'][0]['inlines'][0]['type'] === 'link' && $tweede['blocks'][0]['inlines'][0]['page'] === 'bas' && $tweede['blocks'][0]['inlines'][0]['text'] === 'Bas' && $tweede['blocks'][0]['inlines'][0]['broken'] === false, 'Verwijzing in een lijstpunt');
478 check($tweede['blocks'][0]['inlines'][2]['page'] === 'opmaak' && $tweede['blocks'][0]['inlines'][2]['anchor'] === 'de-lijst' && $tweede['blocks'][0]['inlines'][2]['text'] === 'hier', 'Hoofdstukverwijzing in een lijstpunt');
479 $genest = $tweede['blocks'][1];
480 check($genest['type'] === 'list' && $genest['ordered'] === false && $genest['items'][0]['blocks'][0]['inlines'][1]['type'] === 'em' && $genest['items'][0]['blocks'][0]['inlines'][1]['inlines'][0]['text'] === 'cursief', 'Geneste lijst met cursief');
481 check($lijst[0]['items'][2]['blocks'][0]['inlines'][0]['text'] === 'derde', 'Derde lijstpunt');
482 check($lijst[1]['type'] === 'list' && $lijst[1]['ordered'] === true && !isset($lijst[1]['start']) && count($lijst[1]['items']) === 2 && $lijst[1]['items'][1]['blocks'][0]['inlines'][0]['text'] === 'twee', 'Genummerde lijst vanaf 1');
483 check($lijst[2]['type'] === 'paragraph' && $lijst[2]['inlines'][0]['text'] === 'Tekst ertussen.', 'Een alinea onderbreekt een lijst');
484 check($lijst[3]['ordered'] === true && $lijst[3]['start'] === 3 && $lijst[3]['items'][0]['blocks'][0]['inlines'][0]['text'] === 'vanaf drie', 'Een genummerde lijst bewaart het eerste nummer');
485 check($lijst[4]['inlines'][0]['text'] === 'Een regel' && $lijst[4]['inlines'][1] === ['type' => 'break'] && $lijst[4]['inlines'][2]['text'] === 'met harde breuk.', 'Twee spaties maken een regeleinde');
486 check($lijst[5]['inlines'][0]['text'] === 'Regel' && $lijst[5]['inlines'][1]['type'] === 'break' && $lijst[5]['inlines'][2]['text'] === 'met backslash.', 'Een backslash aan het regeleinde maakt een regeleinde');
487 $citaat = $lijst[6];
488 check($citaat['type'] === 'quote' && $citaat['blocks'][0]['inlines'][1]['type'] === 'link' && $citaat['blocks'][0]['inlines'][1]['page'] === 'bas' && $citaat['blocks'][0]['inlines'][3] === ['type' => 'code', 'text' => '[[geen-code]]'], 'Citaat met verwijzing en code zonder link');
489 $url = $lijst[7]['inlines'];
490 check($url[1]['type'] === 'url' && $url[1]['href'] === 'https://example.com/pad' && $url[1]['inlines'][0]['text'] === 'de site', 'Https-link');
491 check($url[3]['type'] === 'url' && $url[3]['href'] === 'mailto:bas@example.com' && $url[3]['inlines'][0]['text'] === 'mail', 'Mailto-link');
492 check($url[4]['type'] === 'text' && str_contains($url[4]['text'], 'javascript:alert(1)') && str_contains($url[4]['text'], 'data:text/html') && str_contains($url[4]['text'], '//example.com') && str_contains($url[4]['text'], 'JAVASCRIPT:alert(1)'), 'Onveilige url blijft tekst');
493 check(!array_filter($url, fn(array $part): bool => ($part['type'] ?? '') === 'url' && !preg_match('#\A(https?://|mailto:)#i', (string)($part['href'] ?? ''))), 'Alleen http, https en mailto worden een url');
494 $nadruk = $lijst[8]['inlines'];
495 check($nadruk[0]['text'] === 'foo_bar_baz blijft ' && $nadruk[1]['type'] === 'em' && $nadruk[1]['inlines'][0]['text'] === 'wel' && $nadruk[3]['type'] === 'strong' && $nadruk[3]['inlines'][0]['text'] === 'vet', 'Cursief, vet en een underscore in een woord');
496 check($nadruk[5]['type'] === 'em' && $nadruk[5]['inlines'][0]['type'] === 'strong' && $nadruk[5]['inlines'][0]['inlines'][0]['text'] === 'beide', 'Vet en cursief samen');
497 check($nadruk[7]['type'] === 'em' && $nadruk[7]['inlines'][0]['text'] === 'ook', 'Cursief met underscores');
498 $vet = $lijst[9]['inlines'][0];
499 check($vet['type'] === 'strong' && $vet['inlines'][1]['type'] === 'link' && $vet['inlines'][1]['page'] === 'bas' && $vet['inlines'][1]['text'] === 'Bas de vriend' && $vet['inlines'][1]['broken'] === false, 'Verwijzing binnen vet');
500 check($lijst[10]['inlines'][1]['type'] === 'link' && $lijst[10]['inlines'][1]['text'] === 'Bas' && $lijst[10]['inlines'][1]['page'] === 'bas', 'Een verwijzing over een zacht regeleinde blijft een verwijzing');
501 check(str_contains($lijst[11]['inlines'][0]['text'], '<script>alert(1)</script>'), 'HTML blijft tekst naast Markdown');
502 $htmlItem = $lijst[12]['items'][0];
503 check($lijst[12]['type'] === 'list' && str_contains($htmlItem['blocks'][0]['inlines'][0]['text'], '<b>geen html</b>') && $htmlItem['blocks'][0]['inlines'][1]['href'] === 'HTTPS://example.com/Pad', 'HTML in een lijst blijft tekst en HTTPS blijft een link');
504 check($htmlItem['blocks'][1]['type'] === 'list' && $htmlItem['blocks'][1]['ordered'] === true && $htmlItem['blocks'][1]['items'][0]['blocks'][0]['inlines'][0]['text'] === 'genest nummer', 'Geneste genummerde lijst');
505 check($lijst[13]['inlines'] === [['type' => 'text', 'text' => 'a * b * c en een *ster']], 'Losse sterretjes blijven tekst');
506 check($lijst[14]['inlines'] === [['type' => 'text', 'text' => '*niet*']], 'Een escaped sterretje blijft tekst');
507 check($opmaak['chapters'][2]['blocks'][0]['inlines'][0]['text'] === 'Klaar.', 'Het volgende hoofdstuk blijft een alinea');
508
404 509 rejects(fn() => deleteWikiCategory('vriendjes'), 409, 'Categorie met pagina\'s blijft staan');
405 check(deleteWikiPage('bas') === 'bas' && deleteWikiPage('plein') === 'plein' && deleteWikiPage('speelgoedkist') === 'speelgoedkist', 'Pagina\'s verwijderen');
510 check(deleteWikiPage('bas') === 'bas' && deleteWikiPage('plein') === 'plein' && deleteWikiPage('speelgoedkist') === 'speelgoedkist' && deleteWikiPage('opmaak') === 'opmaak', 'Pagina\'s verwijderen');
406 511 check(deleteWikiCategory('vriendjes') === 'vriendjes', 'Lege categorie verwijderen');
407 512 check(array_column(listWikiCategories()['categories'], 'slug') === ['plekken', 'speeltjes'], 'Verwijderde categorie is weg, de andere blijven');
408 513 deleteWikiCategory('plekken');
@@ -25,13 +25,22 @@ function rejects(callable $fn, int $status, string $label): void {
25}
25}
26function wikiLinks(array $page): array {
26function wikiLinks(array $page): array {
27 $links = [];
27 $links = [];
28 foreach ($page['chapters'] as $chapter) {
28 $walkInlines = function (array $inlines) use (&$walkInlines, &$links): void {
29 foreach ($chapter['blocks'] as $block) {
29 foreach ($inlines as $inline) {
30 foreach ($block['inlines'] as $inline) {
30 if (($inline['type'] ?? '') === 'link') $links[] = $inline;
31 if (($inline['type'] ?? '') === 'link') $links[] = $inline;
31 if (isset($inline['inlines']) && is_array($inline['inlines'])) $walkInlines($inline['inlines']);
32 }
33 };
34 $walkBlocks = function (array $blocks) use (&$walkBlocks, $walkInlines): void {
35 foreach ($blocks as $block) {
36 if (isset($block['inlines']) && is_array($block['inlines'])) $walkInlines($block['inlines']);
37 if (($block['type'] ?? '') === 'list') {
38 foreach ($block['items'] ?? [] as $item) $walkBlocks($item['blocks'] ?? []);
32 }
39 }
40 if (($block['type'] ?? '') === 'quote') $walkBlocks($block['blocks'] ?? []);
33 }
41 }
34 }
42 };
43 foreach ($page['chapters'] as $chapter) $walkBlocks($chapter['blocks']);
35 return $links;
44 return $links;
36}
45}
37function three(string $prefix = 'Verhaal'): array {
46function three(string $prefix = 'Verhaal'): array {
@@ -156,7 +165,8 @@ check($export['api_keys'][0]['prefix'] === $key['prefix'] && $export['api_keys']
156$secret = config()['key_secret'] ?? '';
165$secret = config()['key_secret'] ?? '';
157check(is_string($secret) && preg_match('/^[a-f0-9]{64}$/', $secret) === 1, 'key_secret wordt automatisch aangemaakt');
166check(is_string($secret) && preg_match('/^[a-f0-9]{64}$/', $secret) === 1, 'key_secret wordt automatisch aangemaakt');
158file_put_contents($root.'/config.php', str_replace("'base_url' => ''", "'base_url' => 'https://projects.timfalken.com/verhaaltjesboek'", (string)file_get_contents($root.'/config.php')));
167file_put_contents($root.'/config.php', str_replace("'base_url' => ''", "'base_url' => 'https://projects.timfalken.com/verhaaltjesboek'", (string)file_get_contents($root.'/config.php')));
159check(str_contains(authHint('missing'), 'geen Authorization-header') && str_contains(authHint('missing'), 'https://projects.timfalken.com/verhaaltjesboek/docs.php'), 'Ontbrekende header legt uit waar de sleutel vandaan komt');
168check(str_contains(authHint('missing'), 'geen Authorization-header') && str_contains(authHint('missing'), 'https://projects.timfalken.com/verhaaltjesboek/docs.php') && str_contains(authHint('missing'), '/#/beheer') && !str_contains(authHint('missing'), '/#/sleutels'), 'Ontbrekende header wijst naar Beheer');
169check(str_contains(authHint('admin'), 'Open Beheer op https://projects.timfalken.com/verhaaltjesboek/#/beheer') && !str_contains(authHint('admin'), '/#/sleutels'), 'Sleutelbeheer wijst naar Beheer');
160check(str_contains(authHint('format'), 'verkeerde formaat') && str_contains(authHint('rejected'), 'onbekend of ingetrokken') && str_contains(authHint('writer'), 'API-sleutel of als beheerder'), 'De uitleg onderscheidt formaat, afwijzing en rechten');
170check(str_contains(authHint('format'), 'verkeerde formaat') && str_contains(authHint('rejected'), 'onbekend of ingetrokken') && str_contains(authHint('writer'), 'API-sleutel of als beheerder'), 'De uitleg onderscheidt formaat, afwijzing en rechten');
161
171
162check(weekBounds('2026-10-05') === [
172check(weekBounds('2026-10-05') === [
@@ -324,7 +334,7 @@ $plein = createWikiPage([
324check(array_column($plein['chapters'], 'anchor') === ['inleiding', 'de-boom', 'de-bank'], 'Inleiding en hoofdstukken krijgen stabiele ankers');
334check(array_column($plein['chapters'], 'anchor') === ['inleiding', 'de-boom', 'de-bank'], 'Inleiding en hoofdstukken krijgen stabiele ankers');
325check($plein['chapters'][0]['title'] === null && $plein['chapters'][1]['title'] === 'De boom', 'De inleiding heeft geen eigen titel');
335check($plein['chapters'][0]['title'] === null && $plein['chapters'][1]['title'] === 'De boom', 'De inleiding heeft geen eigen titel');
326check(wikiHasPages() === true && wikiVisible(false) === true, 'Met een pagina ziet ook een lezer de wiki');
336check(wikiHasPages() === true && wikiVisible(false) === true, 'Met een pagina ziet ook een lezer de wiki');
327check($plein['chapters'][0]['blocks'][0]['inlines'][0]['text'] === 'Achter de huizen.', 'Tekst vóór het eerste hoofdstuk blijft een alinea');
337check($plein['chapters'][0]['blocks'][0]['type'] === 'paragraph' && $plein['chapters'][0]['blocks'][0]['inlines'][0]['text'] === 'Achter de huizen.', 'Tekst vóór het eerste hoofdstuk blijft een alinea');
328$terug = wikiLinks($plein)[0];
338$terug = wikiLinks($plein)[0];
329check($terug['broken'] === false && $terug['page'] === 'oude-plein' && $terug['anchor'] === 'inleiding' && $terug['text'] === 'terug', 'Verwijzing naar een hoofdstuk op dezelfde pagina');
339check($terug['broken'] === false && $terug['page'] === 'oude-plein' && $terug['anchor'] === 'inleiding' && $terug['text'] === 'terug', 'Verwijzing naar een hoofdstuk op dezelfde pagina');
330
340
@@ -401,8 +411,103 @@ rejects(fn() => loadWikiPage('oude-plein'), 404, 'De oude slug bestaat niet meer
401$brokenPage = wikiLinks(loadWikiPage('bas'))[0];
411$brokenPage = wikiLinks(loadWikiPage('bas'))[0];
402check($brokenPage['text'] === 'oude plein' && $brokenPage['broken'] === true, 'Een verwijzing naar de oude slug wordt zichtbaar kapot');
412check($brokenPage['text'] === 'oude plein' && $brokenPage['broken'] === true, 'Een verwijzing naar de oude slug wordt zichtbaar kapot');
403
413
414$opmaak = createWikiPage([
415 'title' => 'Opmaak',
416 'slug' => 'opmaak',
417 'category' => 'plekken',
418 'content' => implode("\n", [
419 'Inleiding met een',
420 'zachte regel.',
421 '',
422 '# geen hoofdstuk',
423 '',
424 '## De lijst',
425 '',
426 '- appel **rood**',
427 '- [[bas|Bas]] en [[#de-lijst|hier]]',
428 ' - genest met *cursief*',
429 '- derde',
430 '',
431 '1. een',
432 '2. twee',
433 '',
434 'Tekst ertussen.',
435 '',
436 '3. vanaf drie',
437 '',
438 'Een regel ',
439 'met harde breuk.',
440 '',
441 'Regel\\',
442 'met backslash.',
443 '',
444 '> Een citaat met [[bas]] en `[[geen-code]]`.',
445 '',
446 'Zie [de site](https://example.com/pad) en [mail](mailto:bas@example.com).',
447 'Niet [xss](javascript:alert(1)) en niet [data](data:text/html,x) en niet [rel](//example.com) en niet [groot](JAVASCRIPT:alert(1)).',
448 '',
449 'foo_bar_baz blijft *wel* cursief en __vet__ en ***beide*** en _ook_.',
450 '',
451 '**zie [[bas]] in vet**',
452 '',
453 'Zie [[bas|',
454 'Bas]] morgen.',
455 '',
456 '<script>alert(1)</script>',
457 '',
458 '- <b>geen html</b> en [veilig](HTTPS://example.com/Pad)',
459 ' 1. genest nummer',
460 '',
461 'a * b * c en een *ster',
462 '',
463 '\*niet\*',
464 '',
465 '## Samen',
466 '',
467 'Klaar.',
468 ]),
469]);
470check(array_column($opmaak['chapters'], 'anchor') === ['inleiding', 'de-lijst', 'samen'], 'Markdown verandert de hoofdstukken en ankers niet');
471check($opmaak['chapters'][0]['blocks'][0]['inlines'] === [['type' => 'text', 'text' => 'Inleiding met een zachte regel.']], 'Een zacht regeleinde blijft een spatie');
472check($opmaak['chapters'][0]['blocks'][1]['inlines'][0]['text'] === '# geen hoofdstuk', 'Een hekje zonder twee hekjes blijft tekst');
473$lijst = $opmaak['chapters'][1]['blocks'];
474check($lijst[0]['type'] === 'list' && $lijst[0]['ordered'] === false && count($lijst[0]['items']) === 3, 'Ongeordende lijst');
475check($lijst[0]['items'][0]['blocks'][0]['inlines'][0] === ['type' => 'text', 'text' => 'appel '] && $lijst[0]['items'][0]['blocks'][0]['inlines'][1]['type'] === 'strong' && $lijst[0]['items'][0]['blocks'][0]['inlines'][1]['inlines'] === [['type' => 'text', 'text' => 'rood']], 'Vet in een lijstpunt');
476$tweede = $lijst[0]['items'][1];
477check($tweede['blocks'][0]['inlines'][0]['type'] === 'link' && $tweede['blocks'][0]['inlines'][0]['page'] === 'bas' && $tweede['blocks'][0]['inlines'][0]['text'] === 'Bas' && $tweede['blocks'][0]['inlines'][0]['broken'] === false, 'Verwijzing in een lijstpunt');
478check($tweede['blocks'][0]['inlines'][2]['page'] === 'opmaak' && $tweede['blocks'][0]['inlines'][2]['anchor'] === 'de-lijst' && $tweede['blocks'][0]['inlines'][2]['text'] === 'hier', 'Hoofdstukverwijzing in een lijstpunt');
479$genest = $tweede['blocks'][1];
480check($genest['type'] === 'list' && $genest['ordered'] === false && $genest['items'][0]['blocks'][0]['inlines'][1]['type'] === 'em' && $genest['items'][0]['blocks'][0]['inlines'][1]['inlines'][0]['text'] === 'cursief', 'Geneste lijst met cursief');
481check($lijst[0]['items'][2]['blocks'][0]['inlines'][0]['text'] === 'derde', 'Derde lijstpunt');
482check($lijst[1]['type'] === 'list' && $lijst[1]['ordered'] === true && !isset($lijst[1]['start']) && count($lijst[1]['items']) === 2 && $lijst[1]['items'][1]['blocks'][0]['inlines'][0]['text'] === 'twee', 'Genummerde lijst vanaf 1');
483check($lijst[2]['type'] === 'paragraph' && $lijst[2]['inlines'][0]['text'] === 'Tekst ertussen.', 'Een alinea onderbreekt een lijst');
484check($lijst[3]['ordered'] === true && $lijst[3]['start'] === 3 && $lijst[3]['items'][0]['blocks'][0]['inlines'][0]['text'] === 'vanaf drie', 'Een genummerde lijst bewaart het eerste nummer');
485check($lijst[4]['inlines'][0]['text'] === 'Een regel' && $lijst[4]['inlines'][1] === ['type' => 'break'] && $lijst[4]['inlines'][2]['text'] === 'met harde breuk.', 'Twee spaties maken een regeleinde');
486check($lijst[5]['inlines'][0]['text'] === 'Regel' && $lijst[5]['inlines'][1]['type'] === 'break' && $lijst[5]['inlines'][2]['text'] === 'met backslash.', 'Een backslash aan het regeleinde maakt een regeleinde');
487$citaat = $lijst[6];
488check($citaat['type'] === 'quote' && $citaat['blocks'][0]['inlines'][1]['type'] === 'link' && $citaat['blocks'][0]['inlines'][1]['page'] === 'bas' && $citaat['blocks'][0]['inlines'][3] === ['type' => 'code', 'text' => '[[geen-code]]'], 'Citaat met verwijzing en code zonder link');
489$url = $lijst[7]['inlines'];
490check($url[1]['type'] === 'url' && $url[1]['href'] === 'https://example.com/pad' && $url[1]['inlines'][0]['text'] === 'de site', 'Https-link');
491check($url[3]['type'] === 'url' && $url[3]['href'] === 'mailto:bas@example.com' && $url[3]['inlines'][0]['text'] === 'mail', 'Mailto-link');
492check($url[4]['type'] === 'text' && str_contains($url[4]['text'], 'javascript:alert(1)') && str_contains($url[4]['text'], 'data:text/html') && str_contains($url[4]['text'], '//example.com') && str_contains($url[4]['text'], 'JAVASCRIPT:alert(1)'), 'Onveilige url blijft tekst');
493check(!array_filter($url, fn(array $part): bool => ($part['type'] ?? '') === 'url' && !preg_match('#\A(https?://|mailto:)#i', (string)($part['href'] ?? ''))), 'Alleen http, https en mailto worden een url');
494$nadruk = $lijst[8]['inlines'];
495check($nadruk[0]['text'] === 'foo_bar_baz blijft ' && $nadruk[1]['type'] === 'em' && $nadruk[1]['inlines'][0]['text'] === 'wel' && $nadruk[3]['type'] === 'strong' && $nadruk[3]['inlines'][0]['text'] === 'vet', 'Cursief, vet en een underscore in een woord');
496check($nadruk[5]['type'] === 'em' && $nadruk[5]['inlines'][0]['type'] === 'strong' && $nadruk[5]['inlines'][0]['inlines'][0]['text'] === 'beide', 'Vet en cursief samen');
497check($nadruk[7]['type'] === 'em' && $nadruk[7]['inlines'][0]['text'] === 'ook', 'Cursief met underscores');
498$vet = $lijst[9]['inlines'][0];
499check($vet['type'] === 'strong' && $vet['inlines'][1]['type'] === 'link' && $vet['inlines'][1]['page'] === 'bas' && $vet['inlines'][1]['text'] === 'Bas de vriend' && $vet['inlines'][1]['broken'] === false, 'Verwijzing binnen vet');
500check($lijst[10]['inlines'][1]['type'] === 'link' && $lijst[10]['inlines'][1]['text'] === 'Bas' && $lijst[10]['inlines'][1]['page'] === 'bas', 'Een verwijzing over een zacht regeleinde blijft een verwijzing');
501check(str_contains($lijst[11]['inlines'][0]['text'], '<script>alert(1)</script>'), 'HTML blijft tekst naast Markdown');
502$htmlItem = $lijst[12]['items'][0];
503check($lijst[12]['type'] === 'list' && str_contains($htmlItem['blocks'][0]['inlines'][0]['text'], '<b>geen html</b>') && $htmlItem['blocks'][0]['inlines'][1]['href'] === 'HTTPS://example.com/Pad', 'HTML in een lijst blijft tekst en HTTPS blijft een link');
504check($htmlItem['blocks'][1]['type'] === 'list' && $htmlItem['blocks'][1]['ordered'] === true && $htmlItem['blocks'][1]['items'][0]['blocks'][0]['inlines'][0]['text'] === 'genest nummer', 'Geneste genummerde lijst');
505check($lijst[13]['inlines'] === [['type' => 'text', 'text' => 'a * b * c en een *ster']], 'Losse sterretjes blijven tekst');
506check($lijst[14]['inlines'] === [['type' => 'text', 'text' => '*niet*']], 'Een escaped sterretje blijft tekst');
507check($opmaak['chapters'][2]['blocks'][0]['inlines'][0]['text'] === 'Klaar.', 'Het volgende hoofdstuk blijft een alinea');
508
404rejects(fn() => deleteWikiCategory('vriendjes'), 409, 'Categorie met pagina\'s blijft staan');
509rejects(fn() => deleteWikiCategory('vriendjes'), 409, 'Categorie met pagina\'s blijft staan');
405check(deleteWikiPage('bas') === 'bas' && deleteWikiPage('plein') === 'plein' && deleteWikiPage('speelgoedkist') === 'speelgoedkist', 'Pagina\'s verwijderen');
510check(deleteWikiPage('bas') === 'bas' && deleteWikiPage('plein') === 'plein' && deleteWikiPage('speelgoedkist') === 'speelgoedkist' && deleteWikiPage('opmaak') === 'opmaak', 'Pagina\'s verwijderen');
406check(deleteWikiCategory('vriendjes') === 'vriendjes', 'Lege categorie verwijderen');
511check(deleteWikiCategory('vriendjes') === 'vriendjes', 'Lege categorie verwijderen');
407check(array_column(listWikiCategories()['categories'], 'slug') === ['plekken', 'speeltjes'], 'Verwijderde categorie is weg, de andere blijven');
512check(array_column(listWikiCategories()['categories'], 'slug') === ['plekken', 'speeltjes'], 'Verwijderde categorie is weg, de andere blijven');
408deleteWikiCategory('plekken');
513deleteWikiCategory('plekken');