Configurazione DokuWiki

La maggior parte delle caratteristiche di DokuWiki può essere configurato attraverso varie opzioni di configurazione. Il modo più semplice per modificare queste opzioni utilizzando i tasti Configuration Manager.

Che cosa può essere configurato in DokuWiki

Il “system” e le opzioni di DokuWiki si trovano nel file conf/dokuwiki.php. Tuttavia, questo file contiene il “default” dei valori di sistema. Per personalizzare, si dovrebbe modificare il file conf/local.php oppure crearlo se non esiste. Per trovare quello che si può configurare all'interno di quel file, vedere l'elenco delle available options sotto.

Il nome utente, (criptato) e le password di accesso con le regole di controllo sono memorizzati nella users.auth.php and acl.auth.php.

Durante il caricamento di un nuovo file all'interno della MediaManager, è possibile riscontrare un “Upload denied. This file extension is forbidden!” messaggio. Questa estensione del file è proibito! conf/mime.conf file. Per caricare un nuovo tipo di file, specificare entro i mime.conf file.

Alcune sostituzioni automatiche sono fatto quando si modificano le pagine. Alcuni generare tooltips, smiley o alcuni caratteri speciali. Questo comportamento è controllato dal acronyms.conf, smileys.conf oppure entities.conf.

Summary of the configuration files

All configuration files are to be found in the ./conf folder or /etc/dokuwiki when installed from a Debian package.

“Main files” usually ship with DokuWiki, whereas “local files” have to be created by the wiki admin.

If local files are supported you should use them instead of modifying the main files to avoid upgrade troubles.

main file	local file	type of config	quick info
`dokuwiki.php`	`local.php` `local.protected.php`	see below	general wiki configuration
`acronyms.conf`	`acronyms.local.conf`	abbreviations	automatic abbreviation hints
`entities.conf`	`entities.local.conf`	entities	automatic text replacements
`interwiki.conf`	`interwiki.local.conf`	interwiki	interwiki shortcut links
`mime.conf`	`mime.local.conf`	mime	mime type settings for uploads
`smileys.conf`	`smileys.local.conf`	smileys	image replacements
	`acl.auth.php`	see acl	Access Control settings
	`users.auth.php`	see acl	Users and passwords
`license.php`	`license.local.php`	license	list of available licenses
`scheme.conf`	`scheme.local.conf`		URL schemes to be recognized as links
`mediameta.php`		exif	Metadata editable for images
`wordblock.conf`	`wordblock.local.conf`	blacklist	Spam blacklist
	`userscript.js`	javascript	Custom JavaScript enhancements
	`userstyle.css`	css	Custom CSS enhancements

Configuration Options

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:

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 1 or 0
Arrays contain multiple values of one of the above types

Available Options

Basic Settings
- title
- start
- lang
- template
- license
- savedir
- basedir
- baseurl
- dmode
- fmode
- allowdebug
Display Settings
- recent
- breadcrumbs
- youarehere
- fullpath
- typography
- dformat
- signature
- showuseras
- toptoclevel
- tocminheads
- maxtoclevel
- maxseclevel
- camelcase
- deaccent
- useheading
- refcheck
- refshow
Authentication Settings
Anti-Spam Settings
Editing Settings
- usedraft
- htmlok
- phpok
- notify
- subscribers
- locktime
- cachetime
Link Settings
- target (wiki, interwiki, extern, media, windows)
Media Settings
Advanced options
- updatecheck
- userewrite
- useslash
- sepchar
- canonical
- fnencode
- autoplural
- mailfrom
- compress
- gzip_output
- hidepages
- send404
- compression
- sitemap
- rss_type
- rss_linkto
- rss_content
- rss_update
- recent_days
- rss_show_summary
- broken_iua
- xsendfile
- xmlrpc
- xmlrpcuser
- renderer_xhtml
Network Settings