---
type: issue
id: "0050"
status: done
created: 2026-08-12
milestone: M4
priority: low
area: infrastructure
related: [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.