LLM-Wiki

Wiki-Veröffentlichung mit Quartz

Properties1
tagstools, quartz, veröffentlichung, workflow

2 Min. Lesezeit

Wiki-Veröffentlichung mit Quartz

Zusammenfassung: Dieses Wiki wird als statische Website unter https://czybor.i234.me/wiki/ veröffentlicht. Quartz (~/Dokumente/daten/sandbox/aux/quartz) baut die Markdown-Artikel zu HTML; ein rsync-Schritt synchronisiert das Ergebnis in den gemounteten Web-Ordner des NAS (~/Dokumente/homepage).

Workflow nach dem Kuratieren

Wird automatisch nach jedem k ausgeführt (Schritt 9 im Kuratierungs-Workflow, siehe AGENTS.md). Bei Bedarf auch manuell:

cd ~/Dokumente/daten/sandbox/aux/quartz
nvm use 22
npx quartz build -d ../llm_wiki/wiki
rsync -rt --delete public/ ~/Dokumente/homepage/wiki/

Konfiguration

  • quartz.config.yaml (lokal, basiert auf quartz.config.default.yaml):
    • baseUrl: czybor.i234.me/wiki
    • pageTitle: LLM-Wiki, locale: de-DE
    • ignorePatterns enthält _templates/** (Vorlage wird nicht publiziert)
  • Node ≥ 22 erforderlich – via nvm (nvm use 22), System-Default bleibt nicht angefasst.

Wichtige Patches

  1. quartz/plugins/emitters/helpers.ts: HTML-Seiten werden als slug/index.html statt slug.html geschrieben (Ausnahmen: Root-index, Root-404.html, Slugs, die auf /index enden). Grund: Die verlinkten URLs sind endungslos und der NAS-Webserver löst pfad.html nicht auf.
  2. quartz/util/path.ts: pathToRoot/resolveRelative sind verzeichnisbewusst überschrieben – relative Asset-/Linkpfade passen zur URL-Tiefe der slug/-Verzeichnisse (../../ statt ../). Ohne diesen Patch laden Artikelseiten ihr Stylesheet nicht (Style-Verlust, auffällig beim Graph-Klick).
  3. quartz/components/scripts/spa.inline.ts: Die SPA-Navigation nutzt die finale URL nach Server-Redirect (res.url) als Basis für normalizeRelativeURLs.

Bei einem Quartz-Update müssen alle drei Patches neu eingespielt werden.

Struktur

URLQuelle
/wiki/wiki/index.md
/wiki/<ordner>/<ordner>/index.md (Landingpage je Themenbereich)
/wiki/<ordner>/<artikel>/einzelner Artikel
/wiki/tags/<tag>/automatische Tag-Seiten

Die Landingpages der Themenordner wurden am 26.08.2026 automatisch generiert (Titel + Artikelliste); bei neuen Artikeln ggf. ergänzen.

Abgelöstes Setup

Der frühere lokale Leseserver (quartz-wiki.service, Port 8080) ist entfernt; Obsidian wurde deinstalliert. Lesen erfolgt ausschließlich über die Website.

Verwandte Artikel: LLM-Wiki Index

Graphansicht

Backlinks