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.php
souboru. Tento soubor však obsahuje „výchozí“ hodnoty systému. Chcete-li jej přizpůsobit, měli byste soubor upravit conf/local.php
nebo 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.conf
souboru. 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 ./conf
složce nebo /etc/dokuwiki
př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.php local.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.php plugins.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.php
souboru. 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í pluginyconf/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_cascade
promě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.php
lze použít pro nastavení konfigurace, které nelze změnit ve Správci konfigurace.
Zde je ukázka conf/local.php
:
${ errors.content }