Wiki ve göz atma

Bu bölümdeki her şey bu sitede canlı çalışır: açılış sayfasının rafları NoteCard bileşenlerinden örülüdür, dizin satırları bir FacetNav’dır, bu metnin üstündeki üstveri şeridi bir TaxonomyLine’dır, kenar çubuğundaki küçük takımyıldız da bir LocalGraph. Hepsi salt görsel bileşenlerdir — kayıt defterini site kendisi çözer ve görüntülenmeye hazır veriyi props olarak geçer. Çözüm yardımcıları paketle gelir: createTaxonomy ile createBacklinks (mekanik pakette, anlam sitede).

§2.1Bağlama: üç satır

src/lib/taxonomy.ts (bu sitenin bütün bağlaması)

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

Kayıt defteri (_meta/taxonomy.ts) içerik ağacında saf veridir: türler, ton renkleriyle alanlar, nokta renkleriyle durumlar — her değerin kendi dillerindeki görünen etiketleriyle. Oraya bir değer ekleyin, bir notu onunla etiketleyin; her göz atma sayfası onu kendiliğinden yakalar — rotalar zaten değere göre parametrelidir.

§2.2Raf ve token’ları

Göz atma sayfaları ikinci bir zeminde durur: sıcak kâğıdı, serif site başlığını, rafın çift puntoluk çizgisini ve kart ızgarasını onlara browse.css, --wb-* token’ları üzerinden verir — iki bağlamlı paletin göz atma yarısı. Bir sayfa bu bağlama body’sindeki tek bir sınıfla girer: wb-root; bağlamın içinde chrome token’ları yeniden eşlenir, böylece aynı gezinme çubuğu iki zeminde de oturur.

§2.3NoteCard

Bir kart, görüntülenmeye hazır veri alır — çözülmüş etiketler, tonlar, biçimlenmiş bir tarih, ayna bağlantıları. Kartların evi raftır; bu yüzden örnek, okuma sütununun içine gömülü küçük bir raf bağlamı parçasında (.wb-root.wb-inset) duruyor:

Referans2026.08
Hepsi bir arada
Markdown işlem hattının her ögesi bu sayfada birer kez sahne alır.
İşlem hattıHer dem yeşilEN
Referans3 chapters2026.08
Bileşen takımı
Paketle gelen her bileşenin üç bölümlük turu — aynı zamanda canlı bir hub gösterimi.
BileşenlerHer dem yeşil
Hero · HubCard · Stats — hub donatıları, hub’ın kendisinde

§2.4FacetNav

Çok boyutlu göz atma dizini — türler, alanlar (kendi tonlarıyla), öne çıkan etiketler; hepsi önceden çizilmiş hap bağlantılar hâlinde:

Satır etiketleri de props’tur ve varsayılanları İngilizcedir — yukarıdaki örnek labels={{ kind: 'Tür', domain: 'Alan', tag: 'Etiketler', all: 'Tümü →' }} geçiyor, bu sitenin Türkçe dizin sayfalarının geçtiğinin aynısını; başka hiçbir şey değişmez.

§2.5TaxonomyLine, KindBadge, StatusDot, DomainChip

Bir notun başındaki tek satırlık üstveri şeridi, üç rozet atomunun birleşimidir; her atom tek başına da kullanılabilir:

DesenTasarımBüyüyorupdated 2026.08

Atomlar tek başlarına, akan bir satırda: bir Rehber tür rozeti, bir İşlem hattı alan çipi, bir Her dem yeşil durum noktası.

§2.6Backlinks

Bu bahçede her notun altındaki "geri bağlantılar" paneli, paketin createBacklinks yardımcısıyla hesaplanır — motorun kendi wikilink çözücüsü, hedef ← kaynaklar dizinine ters çevrilir; bağlam parçacıkları da yanında gelir. Burada satır içi örnek veriyle:

Gerçeğini görmek için bu sayfanın dibine inin — bu bölümün kendisi bir wikilink hedefidir.

§2.7LocalGraph

Aynı dizin ikinci bir soruyu da yanıtlar — buradan bir adım ötede ne var? — ve index.localGraph(id, titleOf) bunu, gelenler önde olmak üzere bir komşu listesi olarak döndürür. Bileşen komşuları notun çevresindeki bir elips üzerine çizer: gelen bağlantılar düz, gidenler kesik çizgiyle; bir komşu kendi color değerini de taşıyabilir (örneğin ikinci bir koleksiyondan). Burada sütun genişliğinde, örnek veriyle; gerçeği, bağlantısı olan her notun kenar çubuğundadır: