Files
management/docs/issues/0050-wikijs-theming-farben-logo.md

2.9 KiB
Raw Permalink Blame History

type, id, status, created, milestone, priority, area, related
type id status created milestone priority area related
issue 0050 done 2026-08-12 M4 low infrastructure
docs/adr/0014-wikijs-loest-docusaurus-ab.md
docs/issues/0048-wikijs-in-der-suite-deployen.md

Wiki.js: Theming — Docusaurus-Farben und Logo übernehmen

Problem / Motivation

Das neue Wiki soll aussehen wie das aktuelle Docusaurus (Wiedererkennung). Werte aus git.lab/homelab/wiki extrahiert (2026-08-12):

  • Akzent/primary: hell #2b6cb0, dunkel #63b3ed (blau)
  • Farbmodus: dark als Default, respectPrefersColorScheme
  • Hintergrund/Rest: custom.css überschreibt nichts → Docusaurus-Dark-Defaults
  • Logo: homelab/wiki:static/img/logo.png (183×128, rotes Icon), alt „ThreadNet"; Wortmarke threadnet-logo-wortmarke.png (512×512)
  • Favicon: favicon.ico + favicon-32/96.png

Acceptance

  • Wiki.js-Theme: dunkler Default, blauer Akzent (#2b6cb0/#63b3ed), Logo und Favicon aus den obigen Assets übernommen (in das wiki-Repo kopiert, nicht aus homelab/wiki referenziert).
  • Optischer Abgleich gegen den Docusaurus-Stand (Screenshot 2026-08-12).

Notes

Nice-to-have (low), nach #0048/#0049. Assets liegen in homelab/wiki; beim Bau in das neue wiki-Repo kopieren.

Update 2026-08-13 — Umsetzung (Teil)

Live und reproduzierbar über den Konfig-Job (gitops-Commit 63460e7):

  • Dark-Mode als Default.
  • Logo (ThreadNet logo.png) — als statische Datei in Wiki.js gemountet (platform-branding ConfigMap → /_assets/img/branding/), öffentlich ausgeliefert, auf der Login-Seite und eingeloggt sichtbar (kein read:assets für Guests nötig).
  • Login-Hintergrund = alpenglow.jpg, dieselbe Datei wie Authentik/Element (Erweiterung ggü. der ursprünglichen Spec, Wunsch sorb 2026-08-13) — ebenfalls lokal gemountet statt per externer URL verlinkt.

Statt der Spec-Idee „Assets ins wiki-Repo kopieren" liegen sie als eine Quelle in gitops:apps/production/branding/ und werden in den Pod gemountet; später auch in Authentik/Element mountbar (eine Datei, keine Mehrfachpflege).

Noch offen: Akzentfarbe (#2b6cb0/#63b3ed, via injectCSS), Favicon, und der optische Abgleich durch sorb.

Erledigt 2026-08-13 (Rest)

  • Akzentfarbe #2b6cb0 (hell) / #63b3ed (dunkel) via injectCSS auf dem App-UI.
  • Favicon (ThreadNet) für alle Größen ersetzt (favicon.ico, 16/32/150/180/192).
  • Bonus: TOC rechts (tocPosition: right, Wunsch sorb).
  • Abweichung: eine dunkle Login-Karte ist in Wiki.js nicht möglich — der Login-Bundle wendet kein Custom-CSS an; bleibt hell mit dem Alpenglow-Hintergrund.
  • Größen-Detour (für Forks dokumentiert): hochskalierte Favicons + der 604-KB- Hintergrund sprengten kurz das 1-MiB-ConfigMap-Limit → Hintergrund auf 1920 px (400 KB) runterskaliert, alles wieder in EINER platform-branding-ConfigMap.

Optischer Abgleich durch sorb via Screenshots (2026-08-13) erfolgt. → erledigt.