OtterWiki – Anpassungen
Das Wiki des Labor23 (wiki.labor23.org) läuft auf der freien Wiki-Software Otter Wiki. 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.
