Commit ee7b49
2026-06-07 20:30:04 Carsten: new OtterWiki| /dev/null .. labor23/01_infrastruktur/server/otterwiki.md | |
| @@ 0,0 1,33 @@ | |
| + | # OtterWiki – Anpassungen |
| + | |
| + | Das Wiki des Labor23 (wiki.labor23.org) läuft auf der freien Wiki-Software [Otter Wiki](https://otterwiki.com/). Wir verwenden die Software unverändert als Basis, haben aber an einigen Stellen Branding, Optik und ein paar Funktionen an unsere Bedürfnisse angepasst. Diese Seite listet auf, **welche Dateien dafür ausgetauscht bzw. ergänzt wurden, wo sie liegen und warum**, damit die Änderungen auch später nachvollzogen werden können. |
| + | |
| + | Otter Wiki ist so gebaut, dass `custom/`-Dateien automatisch eingebunden werden. |
| + | |
| + | --- |
| + | |
| + | ## 1. `custom/` — Labor23-Branding |
| + | |
| + | Otter Wiki bietet vier offizielle „Custom Hooks", über die man eigenen Code einbinden kann, ohne den Originalcode anzufassen: `custom.css`, `custom.js`, `customHead.html`, `customBody.html`. Genau diese vier Dateien haben wir befüllt, dazu zwei Logo-Grafiken: |
| + | |
| + | | Datei | Zweck / Änderung | |
| + | |---|---| |
| + | | `custom/custom.css` | Eigenes CSS: positioniert unser Logo als Wasserzeichen, sorgt für ein flackerfreies Laden der Seitenleiste, macht Tabellen und Code-Blöcke auf schmalen Bildschirmen scrollbar/umbrechbar | |
| + | | `custom/custom.js` | Aktiviert beim Laden der Seite automatisch den Dark Mode und klappt die Seitenleiste standardmäßig zu | |
| + | | `custom/customHead.html` | Setzt die Hintergrundfarbe schon vor dem JavaScript-Start, damit beim Laden kein heller „Blitz" vor dem Umschalten in den Dark Mode zu sehen ist | |
| + | | `custom/customBody.html` | Bindet das Labor23-Logo als HTML-Element ein (zwei Versionen — hell/dunkel — je nach Modus) | |
| + | | `custom/labor23_logo_black_unofficial@512x.png` | Logo-Variante in Schwarz, wird im hellen Modus angezeigt | |
| + | | `custom/labor23_logo_white@512x.png` | Logo-Variante in Weiß, wird im dunklen Modus angezeigt | |
| + | |
| + | --- |
| + | |
| + | ## 2. `templates/` — gezielt geänderte Seiten-Vorlagen |
| + | |
| + | In `templates/` liegen zwei HTML-Vorlagen (Jinja2-Templates), die im Original-Repo die Ansichten für **Changelog** (`changelog.html`) und **Seitenhistorie** (`history.html`) steuern. |
| + | |
| + | | Datei | Original-Zeile | Unsere Zeile | Änderung | |
| + | |---|---|---|---| |
| + | | `templates/changelog.html` | `{%if not entry.author_email%}{{entry.author_name}}{%else%}<a href="mailto:{{entry.author_email}}">{{entry.author_name}}</a>{%endif%}` | `{{entry.author_name}}` | Die Autor:innen-Spalte zeigt nur noch den **Namen als reinen Text** an, nicht mehr als anklickbaren `mailto:`-Link mit der hinterlegten E-Mail-Adresse | |
| + | | `templates/history.html` | `{%if not entry.author_email%}{{entry.author_name}}{%else%}<a href="mailto:{{entry.author_email}}">{{entry.author_name}}</a>{%endif%}` | `{{entry.author_name}}` | Identische Änderung: auch in der Seitenhistorie erscheint der Name nur noch als Text statt als `mailto:`-Link | |
| + | |
| + | **Warum:** Otter Wiki verlinkt Autor:innen standardmäßig mit ihrer in den Commits hinterlegten E-Mail-Adresse als `mailto:`-Link. Da unser Wiki öffentlich erreichbar ist, wollten wir diese Adressen nicht offen sichtbar/anklickbar machen — daher zeigen wir nur noch den Namen an. Diese eine Zeile ist in beiden Dateien identisch, deshalb wurden gleich beide Templates ausgetauscht. |
