Die meisten Eigenschaften des DokuWiki können durch diverse Optionen konfiguriert werden. Der einfachste Weg die Konfiguration zu bearbeiten ist das Benutzen des Konfigurations Managers.
Die „Systemeinstellungen“ von DokuWiki können in der Datei conf/dokuwiki.php gefunden werden. Diese Datei enthält die Standardeinstellungen des Systems. Um die Einstellungen zu ändern, müssen Sie es in conf/local.php ändern, falls diese Datei nicht existiert, erstellen Sie diese. Eine Liste, welche Einstellungen Sie ändern können, finden Sie in Verfügbare Einstellungen unten.
Benutzernamen, (verschlüsselte) Passwörter und Zugriffskontroll-Regeln sind in users.auth.php and acl.auth.php gespeichert.
Wenn Sie eine neue Datei mit dem Mediamanager hochladen möchten, können Sie auf die Nachricht „Upload denied. This file extension is forbidden!“ stoßen.
Dies Verhalten ist in der Datei conf/mime.conf geregelt. Um einen neuen Datei-Typ hochzuladen, müssen Sie diesen in der Datei mime.conf bestimmen.
Einige Einstellungen werden automatisch geändert, wenn sie Ihre Seiten ändern. Einige erstellen Tooltips, Smileys oder spezielle Zeichen. Diese Verhalten wird in acronyms.conf, smileys.conf oder entities.conf eingestellt.
Alle Konfigurationsdateien befinden sich im ./conf Ordner bzw. in /etc/dokuwiki, wenn ein Debian Paket installiert wird.
„Hauptdateien“ werden normalerweise mit DokuWiki geliefert, hingegen müssen „lokale Dateien“ vom Wiki-Administrator erzeugt werden.
Falls lokale Dateien unterstützt werden, sollten Sie diese nutzen anstatt die Hauptdateien zu ändern, um Probleme beim Update zu vermeiden.
| Hauptdatei | lokale Datei | Konfigurationstyp | Schnellinfo |
|---|---|---|---|
dokuwiki.php | local.phplocal.protected.php | s.u. | Generelle Wiki Konfigurationen |
acronyms.conf | acronyms.local.conf | abbreviations | Automatische Abkürzungstips |
entities.conf | entities.local.conf | entities | Automatische Textersetzung |
interwiki.conf | interwiki.local.conf | interwiki | Interwiki Kurzlinks |
mime.conf | mime.local.conf | mime | Mimetyp-Einstellungen für Uploads |
smileys.conf | smileys.local.conf | smileys | Graphische Ersatz-Smileys |
acl.auth.php | siehe acl | Access-Control-Einstellungen | |
users.auth.php | siehe acl | Benutzer und Paßwörter | |
mediameta.php | exif | Metadaten für Bilder editierbar | |
wordblock.conf | wordblock.local.conf | blacklist | Spam-Blacklist |
userscript.js | javascript | Custom JavaScript Verbesserungen | |
userstyle.css | css | Custom CSS Verbesserungen |
Most of DokuWiki's features can be configured through various config options. The easiest way to modify these options is using the Configuration Manager.
The available settings are listed below. Their default values are stored in a file called conf/dokuwiki.php. If you want to modify a setting you should do this in a file called conf/local.php – this makes sure your special configs are not overwritten by a later upgrade. The config manager will use this file as well.
Here is a sample conf/local.php:
<?php $conf['title'] = "Admin's Wiki."; $conf['useacl'] = 1; $conf['superuser'] = 'admin'; ?>
Some notes about the config file. The file is a piece of PHP code so the PHP syntax has to be preserved. E.g. each line has to have a semicolon at the end. There are multiple types of variables:
9'foo bar'true or false or 1 or 0