Wiki & bladeren

Alles in dit hoofdstuk draait live op deze site: de planken van de landingspagina zijn opgebouwd uit NoteCard, haar facetrijen zijn een FacetNav, de metastrook boven deze tekst is een TaxonomyLine, en het kleine sterrenbeeld in de zijbalk is een LocalGraph. Het zijn allemaal pure weergavecomponenten — de site lost zijn eigen registry op en geeft weergaveklare data door. De oploshulpen reizen met het pakket mee als createTaxonomy en createBacklinks (mechaniek in het pakket, betekenis in de site).

§2.1De koppeling, drie regels

src/lib/taxonomy.ts (de volledige koppeling van deze site)

import { createTaxonomy } from 'astro-inkstone/lib/taxonomy';
import { DOMAINS, KINDS, STATUSES } from '../content/notes/_meta/taxonomy';

export const { getWikiUnits, groupByKind, groupByDomain, groupByPrimaryDomain, tagIndex, resolveTaxonomy } =
  createTaxonomy({ kinds: KINDS, domains: DOMAINS, statuses: STATUSES },
    { collection: 'notes', locales: [{ code: 'zh', prefix: 'zh/' }], primary: 'en' });

De registry (_meta/taxonomy.ts) is pure data in de inhoudsboom: soorten, domeinen met toonkleuren, statussen met puntkleuren, elk met een eigen weergavetekst per taal. Voeg daar een waarde toe, hang hem aan een notitie, en elke bladerpagina pikt hem op — de routes zijn immers per waarde geparametriseerd.

§2.2De boekenplank en haar tokens

Bladerpagina's staan op een tweede ondergrond: browse.css geeft ze het warme papier, de serif-masthead, de tweepunts planklijn en het kaartenraster, alles via de --wb-*-tokens — de plankhelft van het palet met twee contexten. Een pagina stapt die context binnen met één class, wb-root, op haar body; daarbinnen worden de chrome-tokens opnieuw gekoppeld, zodat dezelfde navigatiebalk op beide gronden past.

§2.3NoteCard

Een kaart neemt weergaveklare data aan — opgeloste labels, tonen, een opgemaakte datum, spiegellinks. Kaarten wonen op de plank, dus het voorbeeld staat in een strook plankcontext (.wb-root.wb-inset) binnen deze leeskolom:

Naslag2026.08
De staalkaart
Elk element van de Markdown-pipeline treedt op deze pagina één keer op.
PipelineGroenblijvendEN
Naslag3 chapters2026.08
De componentenset
Een rondgang in drie hoofdstukken langs elk meegeleverd component — en een live hubdemonstratie.
ComponentenGroenblijvend
Hero · HubCard · Stats — het hubmeubilair, op de hub zelf

§2.4FacetNav

De meerdimensionale bladerindex — soorten, domeinen (met hun tonen), populaire tags, allemaal als voorgerenderde pil-links:

Ook de labelteksten zijn props met Engelse standaardwaarden — het voorbeeld hierboven geeft labels={{ kind: 'Soort', domain: 'Domein', tag: 'Tags', all: 'Alles →' }} mee, precies wat de Nederlandse facetpagina's van deze site ook doen; verder verandert er niets.

§2.5TaxonomyLine, KindBadge, StatusDot, DomainChip

De éénregelige metastrook aan het hoofd van een notitie zet de drie badge-atomen in elkaar; elk atoom is ook los te gebruiken:

PatroonOntwerpGroeiendupdated 2026.08

De atomen op zichzelf, in een doorlopende regel: een Gids soortbadge, een Pipeline domeinchip, een Groenblijvend statuspunt.

§2.6Backlinks

Het paneel "Gelinkte vermeldingen" onder elke notitie in deze tuin wordt berekend door createBacklinks uit het pakket — de eigen wikilink-oplosser van de engine, omgekeerd tot een index van doel ← bronnen, contextfragmenten inbegrepen. Hier met inline voorbeelddata:

Scrol naar de voet van deze pagina voor het echte paneel — dit hoofdstuk is zelf een wikilink-doelwit.

§2.7LocalGraph

Dezelfde index beantwoordt nog een tweede vraag — wat ligt hier één sprong vandaan? — en index.localGraph(id, titleOf) levert het antwoord als een lijst buren, inkomend eerst. Het component tekent ze op een ellips rond de notitie, inkomend met een doorgetrokken lijn en uitgaand gestippeld; een buur mag een eigen color meebrengen (uit een tweede collectie, bijvoorbeeld). Hier op kolombreedte, met voorbeelddata; de echte zit in de zijbalk van elke notitie die links heeft: