Merge branch 'cursor/wiki-markdown-94ac' into 'master'
Wiki-Markdown en API-sleutels onder Beheer See merge request Timfa/Verhalenboek!10
@@ -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 [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.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
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.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
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.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
Fouten zijn `{"error":"…"}`. Validatie die de drie-verhalenregel raakt geeft 422. De menselijke uitleg met dezelfde voorbeelden staat op `docs.php`.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
```sh117
```sh118
curl -sS -D - -o - \118
curl -sS -D - -o - \@@ -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; }284
label { display: grid; gap: 0.3rem; font-size: 0.95rem; }291
label { display: grid; gap: 0.3rem; font-size: 0.95rem; }285
input, textarea {292
input, 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;@@ -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
3
const MONTHS = ['januari', 'februari', 'maart', 'april', 'mei', 'juni', 'juli', 'augustus', 'september', 'oktober', 'november', 'december'];3
const MONTHS = ['januari', 'februari', 'maart', 'april', 'mei', 'juni', 'juli', 'augustus', 'september', 'oktober', 'november', 'december'];4
const ROMAN = ['I', 'II', 'III'];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
let renderToken = 0;6
let renderToken = 0;7
let menuAnchor = null;7
let menuAnchor = null;8
let ignoreCloseUntil = 0;8
let ignoreCloseUntil = 0;@@ -578,7 +578,7 @@ async function paintEditor(date) {578
}578
}579
579
580
async function paintBeheer() {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
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
632
function tokenPanel(title, token) {638
function 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
697
function wikiSlugOk(value) {703
function 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
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
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
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
function wikiChapterNode(chapter, currentAnchor) {803
function 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);@@ -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>> 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><script></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>> 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><script></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><script></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' \@@ -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>@@ -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 gewone281
* regeleinde wordt een spatie, twee spaties of een backslash aan het regeleinde282
* een zichtbare breuk. Lijsten, citaten, nadruk, code en externe links komen283
* hierbij; ##-hoofdstukken zijn dan al apart gezet.284
*285
* @return list<array<string,mixed>>286
*/280
function wikiParagraphs(string $body): array {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
$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
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
/** @return list<array<string,mixed>> */463
/** @return list<array<string,mixed>> */293
function wikiParseInlines(string $text): array {464
function 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
*/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>> $tokens719
* @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>> $tokens745
* @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
return $inlines;779
return $inlines;308
}780
}309
781
@@ -388,27 +860,86 @@ function wikiResolveLink(array $link, string $pageSlug, array $catalog): array {388
function wikiResolveChapters(array $chapters, string $pageSlug, array $catalog): array {860
function 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>> $blocks873
* @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>> $inlines901
* @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
function loadWikiPage(string $slug): array {943
function 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();@@ -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
201
function authHint(string $kind): string {201
function 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
}@@ -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 andere3
// Shell-cache voor offline lezen. API, wiki-schrijfacties, inloggen en andere4
// schrijfacties gaan altijd naar het netwerk. Wiki leest en schrijft via api.php4
// schrijfacties gaan altijd naar het netwerk. Wiki leest en schrijft via api.php5
// (Bearer of sessie); die paden worden hieronder overgeslagen en nooit gecachet.5
// (Bearer of sessie); die paden worden hieronder overgeslagen en nooit gecachet.6
const CACHE = 'verhalenboek-v2';6
const CACHE = 'verhalenboek-v3';7
const PRECACHE = [7
const PRECACHE = [8
'assets/favicon.svg',8
'assets/favicon.svg',9
'assets/favicon-32.png',9
'assets/favicon-32.png',@@ -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(@@ -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
}26
function wikiLinks(array $page): array {26
function 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
}37
function three(string $prefix = 'Verhaal'): array {46
function 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'] ?? '';157
check(is_string($secret) && preg_match('/^[a-f0-9]{64}$/', $secret) === 1, 'key_secret wordt automatisch aangemaakt');166
check(is_string($secret) && preg_match('/^[a-f0-9]{64}$/', $secret) === 1, 'key_secret wordt automatisch aangemaakt');158
file_put_contents($root.'/config.php', str_replace("'base_url' => ''", "'base_url' => 'https://projects.timfalken.com/verhaaltjesboek'", (string)file_get_contents($root.'/config.php')));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
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');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
check(weekBounds('2026-10-05') === [172
check(weekBounds('2026-10-05') === [@@ -324,7 +334,7 @@ $plein = createWikiPage([324
check(array_column($plein['chapters'], 'anchor') === ['inleiding', 'de-boom', 'de-bank'], 'Inleiding en hoofdstukken krijgen stabiele ankers');334
check(array_column($plein['chapters'], 'anchor') === ['inleiding', 'de-boom', 'de-bank'], 'Inleiding en hoofdstukken krijgen stabiele ankers');325
check($plein['chapters'][0]['title'] === null && $plein['chapters'][1]['title'] === 'De boom', 'De inleiding heeft geen eigen titel');335
check($plein['chapters'][0]['title'] === null && $plein['chapters'][1]['title'] === 'De boom', 'De inleiding heeft geen eigen titel');326
check(wikiHasPages() === true && wikiVisible(false) === true, 'Met een pagina ziet ook een lezer de wiki');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
$terug = wikiLinks($plein)[0];338
$terug = wikiLinks($plein)[0];329
check($terug['broken'] === false && $terug['page'] === 'oude-plein' && $terug['anchor'] === 'inleiding' && $terug['text'] === 'terug', 'Verwijzing naar een hoofdstuk op dezelfde pagina');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 meer401
$brokenPage = wikiLinks(loadWikiPage('bas'))[0];411
$brokenPage = wikiLinks(loadWikiPage('bas'))[0];402
check($brokenPage['text'] === 'oude plein' && $brokenPage['broken'] === true, 'Een verwijzing naar de oude slug wordt zichtbaar kapot');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
rejects(fn() => deleteWikiCategory('vriendjes'), 409, 'Categorie met pagina\'s blijft staan');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
check(deleteWikiCategory('vriendjes') === 'vriendjes', 'Lege categorie verwijderen');511
check(deleteWikiCategory('vriendjes') === 'vriendjes', 'Lege categorie verwijderen');407
check(array_column(listWikiCategories()['categories'], 'slug') === ['plekken', 'speeltjes'], 'Verwijderde categorie is weg, de andere blijven');512
check(array_column(listWikiCategories()['categories'], 'slug') === ['plekken', 'speeltjes'], 'Verwijderde categorie is weg, de andere blijven');408
deleteWikiCategory('plekken');513
deleteWikiCategory('plekken');