Table of Contents
📝 DokuWiki Setup & Anpassungen
In diesem Kapitel wird die optische und funktionale Anpassung der Wiki-Instanz dokumentiert, um ein professionelles und benutzerfreundliches System zu schaffen.
1. Grundlegende Konfiguration
Nach der erfolgreichen Installation wurden die Basis-Einstellungen über das Admin-Panel und die Datei local.php angepasst:
- Titel: BerkayWiki
- Sprache: Deutsch (de)
- ACL (Zugriffskontrolle): Aktiviert, um den Zugriff auf registrierte Benutzer zu beschränken und die Datenintegrität zu schützen.
2. Corporate Identity (Logo & Favicon)
Um ein individuelles Design zu gewährleisten, wurden das Standard-DokuWiki-Logo und das Favicon durch eigene Grafiken ersetzt.
Vorgehensweise im Terminal: Die Dateien wurden direkt in die entsprechenden Verzeichnisstrukturen des Templates verschoben.
# Verzeichnis für das Template-Logo aufrufen cd /usr/share/dokuwiki/lib/tpl/dokuwiki/images/ # Altes Logo sichern und neues Logo einfügen sudo mv logo.png logo.png.bak sudo wget -O logo.png https://dein-link-zum-logo.png # Favicon im Root-Verzeichnis ersetzen cd /usr/share/dokuwiki/ sudo mv favicon.ico favicon.ico.bak sudo wget -O favicon.ico https://dein-link-zum-favicon.ico
3. Theme & Design-Anpassungen
Während der Entwicklung wurden verschiedene Themes (z. B. Bootstrap3 und SprintDoc) evaluiert, um die beste Darstellung für technische Dokumentationen zu finden.
- Entscheidung: Rückkehr zum Standard-DokuWiki-Theme aufgrund der hohen Stabilität und der hervorragenden Kompatibilität mit dem PDF-Export-Plugin.
- Anpassung: Über die Datei
userall.csswurden kleinere Korrekturen an den Abständen und Farben vorgenommen.
4. Berechtigungsmanagement (Permissions)
Damit das System stabil läuft und Erweiterungen problemlos installiert werden können, wurden die Verzeichnisrechte präzise auf den Webserver-Benutzer zugeschnitten.
# Besitzer rekursiv an den Webserver-User (www-data) übertragen sudo chown -R www-data:www-data /var/lib/dokuwiki/ sudo chown -R www-data:www-data /usr/share/dokuwiki/ # Zugriffsrechte für Verzeichnisse setzen sudo chmod -R 775 /var/lib/dokuwiki/
5. Cache-Management
Bei größeren Änderungen am Design oder der Konfiguration wurde der interne Cache manuell geleert, um die Aktualisierungen sofort sichtbar zu machen.
# Cache-Verzeichnis bereinigen sudo rm -rf /var/lib/dokuwiki/cache/*
