📝 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.css wurden 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/*