====== 📝 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.

<code>
# 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
</code>

===== 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.

<code>
# 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/
</code>

===== 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.

<code>
# Cache-Verzeichnis bereinigen
sudo rm -rf /var/lib/dokuwiki/cache/*
</code>