Wiki i przeglądanie

Wszystko z tego rozdziału działa w tej witrynie na żywo: półki strony głównej są zbudowane z NoteCard, jej wiersze kategorii to FacetNav, pasek metadanych nad tym tekstem to TaxonomyLine, a mała konstelacja w sidebarze to LocalGraph. Wszystkie są czysto prezentacyjne — witryna rozwiązuje swój rejestr i przekazuje dane gotowe do wyświetlenia. Pomocniki rozwiązywania jadą w pakiecie jako createTaxonomy i createBacklinks (mechanika w pakiecie, znaczenie w witrynie).

§2.1Wiązanie w trzech linijkach

src/lib/taxonomy.ts (całe wiązanie tej witryny)

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

Rejestr (_meta/taxonomy.ts) to czyste dane w drzewie treści: rodzaje, obszary z parami odcieni, statusy z kolorami kropek, każda wartość z etykietami wyświetlania dla poszczególnych języków. Dodaj tam wartość, otaguj nią notatkę, a każda strona przeglądania podchwyci ją sama — trasy są przecież parametryzowane wartościami.

§2.2Półka i jej tokeny

Strony przeglądania stoją na drugim podłożu: browse.css daje im ciepły papier, szeryfową winietę, dwupunktową linię półki i siatkę kart, wszystko przez tokeny --wb-* — przeglądową połowę palety o dwóch kontekstach. Strona wchodzi w ten kontekst jedną klasą, wb-root, na swoim body; wewnątrz tokeny chrome’u są przemapowane, więc ten sam pasek nawigacji leży dobrze na każdym z dwóch podłoży.

§2.3NoteCard

Karta przyjmuje dane gotowe do wyświetlenia — rozwiązane etykiety, odcienie, sformatowaną datę, linki do wersji lustrzanych. Karty mieszkają na półce, więc przykład siedzi w skrawku kontekstu przeglądania (.wb-root.wb-inset) osadzonym w tej kolumnie lektury:

Referencja2026.08
Wszystko naraz
Każdy element potoku Markdowna występuje na tej stronie dokładnie raz.
PotokWiecznie zielonaEN
Referencja3 chapters2026.08
Zestaw komponentów
Trzy rozdziały przez każdy dostarczany komponent — i żywy pokaz huba.
KomponentyWiecznie zielona
Hero · HubCard · Stats — wyposażenie huba, na samym hubie

§2.4FacetNav

Wielowymiarowy indeks przeglądania — rodzaje, obszary (z ich odcieniami), najczęstsze tagi, wszystko jako wstępnie wyrenderowane pastylkowe linki:

Etykiety wierszy to również propsy z angielskimi domyślnymi — powyżej przekazano labels={{ kind: 'Rodzaj', domain: 'Obszar', tag: 'Tagi', all: 'Wszystkie →' }}, dokładnie to samo, co przekazują polskie strony kategorii tego ogrodu; poza tym nic się nie zmienia.

§2.5TaxonomyLine, KindBadge, StatusDot, DomainChip

Jednolinijkowy pasek metadanych na czele notatki składa się z trzech atomów-odznak; każdego można też użyć osobno:

WzorzecDesignRosnącaupdated 2026.08

Atomy same, wplecione w bieżący tekst: odznaka rodzaju Przewodnik, chip obszaru Potok, kropka statusu Wiecznie zielona.

§2.6Backlinks

Panel „linki zwrotne” pod każdą notatką tego ogrodu liczy pakietowe createBacklinks — własny resolver wikilinków silnika odwrócony w indeks cel ← źródła, z fragmentami kontekstu włącznie. Tutaj na wbudowanych danych przykładowych:

Przewiń do stóp tej strony po ten prawdziwy — ten rozdział sam jest celem wikilinków.

§2.7LocalGraph

Ten sam indeks odpowiada na drugie pytanie — co jest o jeden skok stąd? — a index.localGraph(id, titleOf) zwraca odpowiedź jako listę sąsiadów, wchodzące najpierw. Komponent rysuje ich na elipsie wokół notatki: wchodzące linią ciągłą, wychodzące przerywaną; sąsiad może nieść własny color (na przykład druga kolekcja). Tutaj na szerokość kolumny, z danymi przykładowymi; ten prawdziwy siedzi w sidebarze każdej notatki, która ma linki: