Konfigurace Dokuwiki
Mnoho funkcí DokuWiki lze konfigurovat pomocí různých možností konfigurace. Nejjednodušší způsob, jak tyto možnosti upravit, je použití nástroje Configuration Manager, který umožňuje správcům wiki snadno měnit nastavení konfigurace wiki online z pohodlí svého oblíbeného webového prohlížeče.
Chcete-li spustit Configuration Manager, přihlaste se jako superuser a klikněte na tlačítko Správce.
Co lze konfigurovat
„Systémové“ možnosti DokuWiki najdete v conf/dokuwiki.phpsouboru. Tento soubor však obsahuje „výchozí“ hodnoty systému. Chcete-li jej přizpůsobit, měli byste soubor upravit conf/local.phpnebo vytvořit, pokud neexistuje. Chcete-li zjistit, co můžete v daném souboru konfigurovat, podívejte se na seznam dostupných možností níže.
Uživatelská jména, (šifrovaná) hesla a pravidla řízení přístupu jsou uložena v souborech users.auth.php a acl.auth.php, které najdete v adresáři conf.
Při nahrávání nového souboru do mediamanager se můžete setkat se “Upload denied. This file extension is forbidden!”zprávou. Toto chování je řízeno v rámci conf/mime.confsouboru. Chcete-li nahrát nový typ souboru, zadejte jej v souboru mime.local.conf .
Některá automatická nahrazení se provádějí při úpravách stránek. Některé generují tipy, smajlíky nebo jiné speciální znaky. Toto chování je řízeno acronyms.conf , smileys.conf nebo entities.conf .
Konfigurační soubory
Všechny konfigurační soubory najdete ve ./confsložce nebo /etc/dokuwikipři instalaci z balíčku Debianu.
„Hlavní soubory“ se obvykle dodávají s DokuWiki, zatímco „místní soubory“ musí být vytvářeny správcem wiki.
Pokud jsou podporovány místní soubory, měli byste je použít místo úpravy hlavních souborů, abyste se vyhnuli problémům s upgradem.
| hlavní soubor | místní soubor | typ konfigurace | rychlé informace | 
|---|---|---|---|
| dokuwiki.php | local.phplocal.protected.php | viz. níže | obecná konfigurace wiki | 
| acronyms.conf | acronyms.local.conf | zkratky | automatické tipy na zkratky | 
| entities.conf | entities.local.conf | subjekty | automatické nahrazování textu | 
| interwiki.conf | interwiki.local.conf | interwiki | odkazy na interwiki | 
| mime.conf | mime.local.conf | mim | nastavení typu mime pro nahrávání | 
| smileys.conf | smileys.local.conf | smajlíky | výměny obrázků | 
| acl.auth.php | viz acl | Nastavení kontroly přístupu | |
| users.auth.php | viz acl | Uživatelé a hesla | |
| license.php | license.local.php | licence | seznam dostupných licencí | 
| scheme.conf | scheme.local.conf | urlschemes | Schémata URL , které mají být rozpoznány jako odkazy | 
| mediameta.php | mediameta.local.php | exif | Metadata upravitelná pro obrázky | 
| wordblock.conf | wordblock.local.conf | černá listina | Spam blacklist | 
| plugins.required.php | plugins.local.phpplugins.protected.php | viz. níže | Povolení / zakázání pluginů | 
| userscript.js | javascript | Vlastní vylepšení JavaScriptu | |
| userstyle.css | css | Vlastní vylepšení CSS | |
| manifest.json | manifest.local.json | manifest | Manifest PWA | 
Konfigurační soubory motivu
Další konfigurační soubory najdete v /var/lib/dokuwiki/lib/tpl/dokuwiki(Debian), např [style.ini](https://www.dokuwiki.org/devel:style.ini "devel:style.ini"). Style.ini je textový soubor, který se čte ve výchozím motivu a uživatel může konfigurovat např. Barvu pozadí.
Povolení / zakázání pluginů
Nainstalované doplňky jsou ve výchozím nastavení povoleny. Mohly by být zakázány pomocí Správce rozšíření, který zapisuje do plugins.local.phpsouboru. Určité doplňky můžete chránit jejich vložením conf/plugins.protected.php.
Ve výchozím nastavení DokuWiki načítá své konfigurační soubory v následujícím pořadí:
- conf/plugins.php- výchozí pluginy
- conf/plugins.local.php- změněno správcem rozšíření
- conf/plugins.required.php- tyto základní pluginy nelze ovládat správcem rozšíření
- conf/plugins.protected.php- přepíše nastavení v ostatních souborech
Pořadí načítání konfiguračních souborů je řízeno globální $config_cascadeproměnnou. Pomocí souboru preload.php můžete toto chování změnit.
Možnosti konfigurace
Většinu funkcí DokuWiki lze konfigurovat pomocí různých možností konfigurace. Nejjednodušší způsob, jak upravit tyto možnosti, je použití nástroje Configuration Manager .
Dostupná nastavení jsou uvedena níže. Jejich výchozí hodnoty jsou uloženy v souboru s názvem conf/dokuwiki.php. Pokud chcete upravit nastavení, měli byste to udělat v souboru s názvem conf/local.php- to zajistí, že vaše speciální konfigurace nebudou přepsány pozdějším upgradem. Config manažer bude tento soubor používat stejně. Soubor conf/local.protected.phplze použít pro nastavení konfigurace, které nelze změnit ve Správci konfigurace.
Zde je ukázka conf/local.php:
                            ${ errors.content }