Konfiguracja DokuWiki

Wiele cech DokuWiki może być costosowanych przez liczne opcje konfiguracji. Najprostszym sposobem zmiany tych opcji jest wykorzystanie Menadżera Konfiguracji, który pozwala administratorom wiki w prosty sposób zmieniać ustawienia wiki przy użyciu ulubionej przeglądarki.

By przejść do Menadżera Konfiguracji zaloguj się jako administrator lub superużytkownik i wciśnij przycisk Administracja u dołu strony.

Co można skonfigurować

Opcje „systemowe” DokuWiki znajdują się w pliku conf/dokuwiki.php. Ten plik przechowuje tylko „domyślne” wartości systemu. By je dostosować, powinieneś zmienić plik conf/local.php lub też go utworzyć, jeśli nie istnieje. By dowiedzieć się, co możesz ustawić w pliku przejrzyj poniższą listę dostępnych opcji|.

Nazwy użytkowników, (zaszyfrowane) hasła i reguły Kontroli Dostępusą przechowywane w users.auth.php i acl.auth.php.

Podczas przesyłania nowego pliku przy użyciu Menadżera Mediów, Możesz spotkać się z komunikatem „Przesyłanie zabronione. To rozszerzenie pliku jest zabronione!”. To działanie kontrolowane jest w pliku conf/mime.conf. Aby przesłać nowy typ pliku, wskaż go w pliku mime.conf.

Podczas edycji strony wykonywane są pewne automatyczne zastąpienia. Niektóre generują dymki, emotki albo znaki specjalne. To zachowanie sterowane jest w plikach acronyms.conf, smileys.conf lub entities.conf.

Pliki konfiguracji

Wszystkie pliki konfiguracji znajdują się w folderze ./conf lub /etc/dokuwiki o ile zainstalowano z pakietu Debiana.

„Pliki podstawowe” zwykle zapewniane są przez DokuWiki, jednakże „pliki lokalne” muszą być utworzone przez administratora wiki.

Jeśli zapewniane są pliki lokalne, powinieneś ich użyć zamiast zmieniać pliki podstawowe by uniknąć problemów podczas aktualizacji.

plik podstawowy	plik lokalny	typ konfiguracji	krótka notka
`dokuwiki.php`	`local.php` `local.protected.php`	patrz poniżej	podstawowa konfiguracja dokuwiki
`acronyms.conf`	`acronyms.local.conf`	abbreviations	automatyczne podpowiedzi skrótów
`entities.conf`	`entities.local.conf`	entities	automatyczne zamiany tekstu
`interwiki.conf`	`interwiki.local.conf`	interwiki	linki skrótów interwiki
`mime.conf`	`mime.local.conf`	mime	ustawienia typów mime dla przesłań plików
`smileys.conf`	`smileys.local.conf`	smileys	zastępowanie obrazków
	`acl.auth.php`	see acl	ustawienia Kontroli Dostępu
	`users.auth.php`	see acl	Użytkownicy i hasła
`license.php`	`license.local.php`	license	ista dostępnych licencji
`scheme.conf`	`scheme.local.conf`	urlschemes	schematy URL rozpoznawane jako linki
`mediameta.php`		exif	edytowalne metadane obrazków
`wordblock.conf`	`wordblock.local.conf`	blacklist	czarna lista spamu
`plugins.required.php`	`plugins.local.php` `plugins.protected.php`	patrz niżej	Włączanie/wyłaczanie wtyczek
	`userscript.js`	javascript	Rozszerzenia użytkownika JavaScript
	`userstyle.css`	css	Rozszerzenia użytkownika CSS

Enabling/disabling plugins

Installed plugins are enabled by default. They could be disabled using the Plugin Manager which writes to the plugins.local.php file. You can protect certain plugins by placing them in conf/plugins.protected.php.

By default DokuWiki loads its configuration files in the following order:

conf/plugins.local.php – changed by plugin manager
conf/plugins.required.php – these core plugins cannot be controlled by plugin manager
conf/plugins.protected.php – overrides setting in the first two files

The loading order of configuration files is controlled by the global $config_cascade variable. By using a preload.php file you can change this behavior.

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. The file conf/local.protected.php can be used for configuration settings which cannot be modified.

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

Dostępne opcje

Ustawienia podstawowe
- title
- start
- lang
- template
- license
- savedir
- basedir
- baseurl
- dmode
- fmode
- allowdebug
Ustawienia wyświetlania
- recent
- breadcrumbs
- youarehere
- fullpath
- typography
- dformat
- signature
- showuseras
- toptoclevel
- tocminheads
- maxtoclevel
- maxseclevel
- camelcase
- deaccent
- useheading
- refcheck
- refshow
Ustawienia autoryzacji
Ustawienia przeciwspamowe
Ustawienia edycyjne
- usedraft
- htmlok
- phpok
- notify
- subscribers
- locktime
- cachetime
Ustawienia linków
- target (wiki, interwiki, extern, media, windows)
Ustawienia multimediów
Opcje zaawansowane
- updatecheck
- userewrite
- useslash
- sepchar
- canonical
- fnencode
- autoplural
- mailfrom
- compress
- cssdatauri
- 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
- readdircache
Ustawienia sieciowe