Konfiguration des DokuWiki

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, mit welchem Administratoren die Einstellungen ihrer DokuWiki-Installation bequem über ihren bevorzugten Webbrowser ändern können.

Um den Konfigurationsmanager zu starten, melde dich als superuser an und klicke auf die Admin-Schaltfläche.

Was kann im DokuWiki konfiguriert werden?

Die DokuWiki-Standardeinstellungen, also in anderen Worten, die „Systemeinstellungen“ der Wiki-Software im Urzustand unmittelbar nach der Installation, sind in der Datei conf/dokuwiki.php zu finden. Für jegliche Benutzerdefinierten Anpassungen dient jedoch die Datei conf/local.php. Falls noch nicht vorhanden, sollte diese zunächst erstellt werden. Innerhalb dieser Datei können Sie anschließend die Konfiguration von DokuWiki bearbeiten. Eine Liste verfügbarer Optionen ist am Ende dieser Seite zu finden.

Benutzernamen, (verschlüsselte) Passwörter und Zugriffskontroll-Regeln werden den Dateien users.auth.php und 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.

Zusammenfassung der Konfigurationsdateien

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.php` `local.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

Konfiguration Einstellungen

Die meisten Einstellungen von DokuWiki können über verschiedene Konfigurationseinstellungen eingestellt werden. Am einfachsten geht das mit dem Configuration Manager.

Die verfügbaren Einstellungen sind unterhalb aufgelistet. Die Standardwerte stehen in der Datei conf/dokuwiki.php. Wenn Sie diese Einstellungen ändern wollen, verwenden Sie die Datei conf/local.php – dadurch wird sicher gestellt, dass diese speziellen Konfiguraionen nicht durch ein späteres Upgrade überschrieben werden. Der Konfigurationsmanager wird diese Datei ebenfalls verwenden.

Hier ist ein Beispiel 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:

Numbers can be written as is. Example: 9
Strings have to be enclosed in single or double quotes. Example: 'foo bar'
Booleans can be either true or false or 1 or 0
Arrays contain multiple values of one of the above types

Verfügbare Einstellungen

Basic Settings
- title
- start
- lang
- template
- license
- savedir
- basedir
- baseurl
- dmode
- fmode
- allowdebug
Display Settings
- recent
- breadcrumbs
- youarehere
- fullpath
- typography
- dformat
- signature
- toptoclevel
- maxtoclevel
- maxseclevel
- camelcase
- deaccent
- useheading
- refcheck
- target
Authentication Settings
Anti-Spam Settings
Editing Settings
- usedraft
- htmlok
- phpok
- locktime
- cachetime
Media Settings
Syndication Options
Advanced options
- userewrite
- useslash
- sepchar
- canonical
- autoplural
- mailfrom
- compress
- gzip_output
- hidepages
- sitemap
- recent_days
- broken_iua
- xsendfile
- remote
- remoteuser
- renderer_xhtml

Network Settings
- updatecheck
- compression
- send404
- proxy
- safemodehack
- ftp