68 lines
2.9 KiB
Markdown
68 lines
2.9 KiB
Markdown
---
|
||
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.
|