Wiki & parcours

§2.1La liaison, en trois lignes

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' });

Le registre (_meta/taxonomy.ts) est de la donnée pure dans l’arbre de contenu : les types, les domaines avec leurs tons, les statuts avec la couleur de leur point, chacun avec ses libellés dans chaque langue du site. Ajoutez-y une valeur, étiquetez une note avec, et chaque page de parcours la reprend — les routes sont paramétrées par valeur.

§2.2L’étagère et ses tokens

Les pages de parcours vivent sur un second fond : browse.css leur donne le papier chaud, le bandeau en serif, le filet d’étagère de 2 pt et la grille de cartes, le tout par les tokens --wb-* — la moitié étagère de la palette à deux contextes. Une page entre dans ce contexte par une seule classe, wb-root, sur son body ; à l’intérieur, les tokens de l’habillage sont re-projetés, si bien que la même barre de navigation se tient sur l’un et l’autre fond.

§2.3NoteCard

Une carte reçoit des données prêtes à afficher — libellés résolus, tons, date déjà mise en forme, liens miroirs. Les cartes vivent sur l’étagère, alors l’échantillon se pose dans un pan du contexte de parcours (.wb-root.wb-inset) au milieu de cette colonne de lecture :

§2.4FacetNav

L’index de parcours multi-dimensions — les types, les domaines (avec leurs tons), les étiquettes de tête, le tout en liens-pastilles prérendus :

Les libellés sont des props, anglais par défaut — la rangée ci-dessus passe labels={{ kind: 'Type', domain: 'Domaine', tag: 'Étiquettes', all: 'Tout →' }}, exactement ce que ce site passe à ses pages de facettes françaises ; rien d’autre ne change.

§2.5TaxonomyLine, KindBadge, StatusDot, DomainChip

Le bandeau de méta d’une ligne en tête de note assemble les trois atomes de badge ; chacun s’emploie aussi seul :

Les atomes pris seuls, au fil d’une ligne : un badge de type Guide, une pastille de domaine Pipeline, un point de statut Pérenne.

§2.6Backlinks

Le panneau « mentions liées » sous chaque note de ce jardin est calculé par le createBacklinks du paquet — le propre résolveur de wikiliens du moteur, retourné en un index cible ← sources, extraits de contexte compris. Ici sur des données d’exemple :

Faites défiler jusqu’au pied de cette page pour voir le vrai — ce chapitre est lui-même une cible de wikiliens.

§2.7LocalGraph

Le même index répond à une seconde question — qu’y a-t-il à un saut d’ici ? — et index.localGraph(id, titleOf) la retourne en liste de voisins, entrants d’abord. Le composant les dessine sur une ellipse autour de la note, entrants en trait plein et sortants en pointillé ; un voisin peut porter sa propre color (une seconde collection, par exemple). Ici à la largeur de la colonne, sur des données d’exemple ; le vrai siège dans la barre latérale de chaque note qui a des liens :