====== Konfigurace DokuWiki ====== https://www.dokuwiki.org/config DokuWiki lze přizpůsobit potřebám pomocí „systémových“ voleb, konfiguračních souborů pro doladění chování, úprav stylu šablony a povolování/zakazování rozšíření. ===== Co lze konfigurovat ===== „Systémové“ volby DokuWiki se nastavují ve [[doku>plugin:config|Správci konfigurace]]. Pro spuštění je potřeba být přihlášen jako superuživatel a v adminu kliknout na tlačítko Admin. „Výchozí“ hodnoty systému jsou načítány ze souboru ''conf/dokuwiki.php''. Pro úpravy je měňte ve Správci konfigurace, který je uloží do ''conf/local.php''. Případně lze tento soubor upravit ručně (nebo vytvořit, pokud neexistuje). Seznam toho, co lze v něm nastavit, viz níže v sekci [[#available options]]. Uživatelská jména, (šifrovaná) hesla a pravidla přístupu se ukládají v souborech [[acl|users.auth.php a acl.auth.php]] v adresáři ''conf/''. Tyto soubory lze upravovat přes [[doku>plugin:usermanager|Správce uživatelů]] a [[doku>plugin:acl|Správu přístupových práv]]. Při nahrávání souboru v media manageru se může objevit hláška ''„Upload denied. This file extension is forbidden!“''. Toto chování se řídí v ''conf/mime.conf''. Chcete‑li povolit nový typ souboru, uveďte jej v [[mime|mime.local.conf]]. Při editaci stránek probíhají automatické záměny (nápovědy ke zkratkám, smajlíci, speciální znaky). Řídí je [[doku>abbreviations|acronyms.conf]], [[smileys|smileys.conf]] a [[doku>entities|entities.conf]]. ===== Konfigurační soubory ===== Konfigurační soubory jsou v ''conf/'' instalace (nebo ''/etc/dokuwiki'' při instalaci z balíčku Debianu). „Hlavní soubory“ se dodávají s DokuWiki, „lokální soubory“ vytváří správce wiki. Pokud jsou podporovány lokální soubory, používejte je místo úprav hlavních souborů, aby se předešlo problémům při upgrade. Alternativou k ruční editaci ''*.conf'' je použití [[doku>plugin:confmanager|Správce konfiguračních souborů]]. ^ hlavní soubor ^ lokální soubor ^ typ konfigurace ^ stručné info ^ | ''dokuwiki.php'' | ''local.php''\\ ''local.protected.php'' | viz níže | obecná konfigurace wiki | | ''acronyms.conf'' | ''acronyms.local.conf'' | [[doku>abbreviations]] | automatické nápovědy ke zkratkám | | ''entities.conf'' | ''entities.local.conf'' | [[doku>entities]] | automatické textové záměny | | ''interwiki.conf'' | ''interwiki.local.conf'' | [[doku>interwiki]] | interwiki zkratkové odkazy | | ''mime.conf'' | ''mime.local.conf'' | [[mime]] | MIME typy pro uploady | | ''smileys.conf'' | ''smileys.local.conf'' | [[smileys]] | obrazové záměny | | | ''acl.auth.php'' | viz [[acl]] | nastavení přístupů | | | ''users.auth.php'' | viz [[acl]] | uživatelé a hesla | | ''license.php'' | ''license.local.php'' | [[doku>config:license]] | seznam dostupných licencí | | ''scheme.conf'' | ''scheme.local.conf'' | [[doku>urlschemes]] | URL schémata rozpoznávaná jako odkazy | | ''mediameta.php'' | ''mediameta.local.php'' | [[exif]] | editovatelná metadata obrázků | | ''wordblock.conf'' | ''wordblock.local.conf'' | [[blacklist]] | spamový blacklist | | ''plugins.required.php'' | ''plugins.local.php''\\ ''plugins.protected.php'' | viz níže | povolení/zakázání pluginů | | ''manifest.json'' | ''manifest.local.json'' | [[doku>devel:manifest]] | PWA manifest | | ''lib/tpl//style.ini'' | ''conf/tpl//style.ini'' | [[doku>devel:style.ini]] | styly a proměnné šablony | | | ''userscript.js'' | [[doku>devel:javascript]] | vlastní JavaScript | | | ''userstyle.css'' | [[doku>devel:css]] | vlastní CSS | ==== Konfigurační soubory šablony ==== Konfigurační soubor ''[[doku>devel:style.ini]]'' pro změny vzhledu je v ''/lib/tpl/dokuwiki'' (pro výchozí šablonu). ''style.ini'' je textový soubor načítaný šablonou, kde lze nastavovat např. barvu pozadí. [[plugin:styling|Plugin Styling]] umožní přes Admin rozhraní náhled a změnu vzhledu libovolné šablony a ukládá do ''conf/tpl//style.ini''. ===== Povolení/zakázání pluginů ===== Nainstalované pluginy jsou ve výchozím stavu povoleny. Zakázat je lze ve [[doku>plugin:extension|Správci rozšíření]], který zapisuje do ''plugins.local.php''. Vybrané pluginy lze „ochránit“ v ''conf/plugins.protected.php''. Výchozí pořadí načítání konfiguračních souborů pluginů: - ''conf/plugins.php'' - výchozí pluginy - ''conf/plugins.local.php'' - změny ze Správce rozšíření - ''conf/plugins.required.php'' - jádrové pluginy mimo kontrolu Správce rozšíření - ''conf/plugins.protected.php'' - přepisuje nastavení z ostatních souborů Pořadí načítání řídí globální proměnná ''$config_cascade''. Chování lze změnit přes [[doku>devel:preload|preload.php]]. ===== Konfigurační volby ===== Většinu funkcí [[dokuwiki|DokuWiki]] lze nastavit různými volbami. Nejjednodušší je úprava přes [[doku>plugin:config|Správce konfigurace]]. Dostupná nastavení jsou níže. Jejich výchozí hodnoty jsou v ''conf/dokuwiki.php''. Úpravy provádějte v ''conf/local.php'', aby je pozdější upgrade nepřepsal. [[doku>plugin:config|Config Manager]] tento soubor také používá. ''conf/local.protected.php'' je pro volby, které nelze měnit ve Správci konfigurace. Ukázka ''conf/local.php'': Poznámky: Jde o PHP soubor, je nutné dodržet syntaxi (např. ukončovací středníky). Typy proměnných: * **Number** (Čísla): např. ''9'' * **String** (Řetězce): musí být uzavřeny v jednoduchých nebo dvojitých uvozovkách., např. ''%%'foo bar'%%'' * **Boolean** (Boolean): ''1'' nebo ''0'' * **Array** (Pole): více hodnot předchozích typů ==== Dostupné volby ==== * **Základní nastavení** * [[doku>config:title|title]] * [[doku>config:startpage|start]] * [[doku>config:lang|lang]] * [[doku>config:template|template]] * [[doku>config:tagline|tagline]] * [[doku>config:sidebar|sidebar]] * [[doku>config:license|license]] * [[doku>config:savedir|savedir]] * [[doku>config:basedir|basedir]] * [[doku>config:baseurl|baseurl]] * [[doku>config:cookiedir|cookiedir]] * [[doku>config:dmode|dmode]] * [[doku>config:fmode|fmode]] * [[doku>config:allowdebug|allowdebug]] * **Zobrazení** * [[doku>config:recent|recent]] * [[doku>config:recent_days|recent_days]] * [[doku>config:breadcrumbs|breadcrumbs]] * [[doku>config:youarehere|youarehere]] * [[doku>config:fullpath|fullpath]] * [[doku>config:typography|typography]] * [[doku>config:dformat|dformat]] * [[doku>config:signature|signature]] * [[doku>config:showuseras|showuseras]] * [[doku>config:toptoclevel|toptoclevel]] * [[doku>config:tocminheads|tocminheads]] * [[doku>config:maxtoclevel|maxtoclevel]] * [[doku>config:maxseclevel|maxseclevel]] * [[doku>config:camelcase|camelcase]] * [[doku>config:deaccent|deaccent]] * [[doku>config:useheading|useheading]] * [[doku>config:sneaky_index|sneaky_index]] * [[doku>config:hidepages|hidepages]] * **Autentizace** * [[doku>config:useacl|useacl]] * [[doku>config:autopasswd|autopasswd]] * [[doku>config:authtype|authtype]] * [[doku>config:passcrypt|passcrypt]] * [[doku>config:defaultgroup|defaultgroup]] * [[doku>config:superuser|superuser]] * [[doku>config:manager|manager]] * [[doku>config:profileconfirm|profileconfirm]] * [[doku>config:rememberme|rememberme]] * [[doku>config:disableactions|disableactions]] * [[doku>config:auth_security_timeout|auth_security_timeout]] * [[doku>config:securecookie|securecookie]] * [[doku>config:samesitecookie|samesitecookie]] * [[doku>config:remote|remote]] * [[doku>config:remoteuser|remoteuser]] * [[doku>config:remotecors|remotecors]] * **Ochrana proti spamu** * [[doku>config:usewordblock|usewordblock]] * [[doku>config:relnofollow|relnofollow]] * [[doku>config:indexdelay|indexdelay]] * [[doku>config:mailguard|mailguard]] * [[doku>config:iexssprotect|iexssprotect]] * **Úpravy** * [[doku>config:usedraft|usedraft]] * [[doku>config:htmlok|htmlok]] (removed since release 2023 Jack Jackrum) * [[doku>config:phpok|phpok]] (removed since release 2023 Jack Jackrum) * [[doku>config:locktime|locktime]] * [[doku>config:cachetime|cachetime]] * **Odkazy** * [[doku>config:target|target (wiki, interwiki, extern, media, windows)]] * **Média** * [[doku>config:mediarevisions|mediarevisions]] * [[doku>config:gdlib|gdlib]] * [[doku>config:im_convert|im_convert]] * [[doku>config:jpg_quality|jpg_quality]] * [[doku>config:fetchsize|fetchsize]] * [[doku>config:refcheck|refcheck]] * **Oznámení** * [[doku>config:subscribers|subscribers]] * [[doku>config:subscribe_time|subscribe_time]] * [[doku>config:notify|notify]] * [[doku>config:registernotify|registernotify]] * [[doku>config:mailfrom|mailfrom]] * [[doku>config:mailreturnpath|mailreturnpath]] * [[doku>config:mailprefix|mailprefix]] * [[doku>config:htmlmail|htmlmail]] * [[doku>config:dontlog|dontlog]] * [[doku>config:logretain|logretain]] * **Syndikace (RSS)** * [[doku>config:sitemap|sitemap]] * [[doku>config:rss_type|rss_type]] * [[doku>config:rss_linkto|rss_linkto]] * [[doku>config:rss_content|rss_content]] * [[doku>config:rss_media|rss_media]] * [[doku>config:rss_update|rss_update]] * [[doku>config:rss_show_summary|rss_show_summary]] * [[doku>config:rss_show_deleted|rss_show_deleted]] * **Pokročilé volby** * [[doku>config:updatecheck|updatecheck]] * [[doku>config:userewrite|userewrite]] * [[doku>config:useslash|useslash]] * [[doku>config:sepchar|sepchar]] * [[doku>config:canonical|canonical]] * [[doku>config:fnencode|fnencode]] * [[doku>config:autoplural|autoplural]] * [[doku>config:compress|compress]] * [[doku>config:cssdatauri|cssdatauri]] * [[doku>config:gzip_output|gzip_output]] * [[doku>config:send404|send404]] * [[doku>config:compression|compression]] * [[doku>config:broken_iua|broken_iua]] * [[doku>config:xsendfile|xsendfile]] * [[doku>config:renderer_xhtml|renderer_xhtml]] * [[doku>config:readdircache|readdircache]] * [[doku>config:search_nslimit|search_nslimit]] * [[doku>config:search_fragment|search_fragment]] * **Síť** * [[doku>config:dnslookups|dnslookups]] * [[doku>config:jquerycdn|jquerycdn]] * [[doku>config:trustedproxy|trustedproxy]] * [[doku>config:trustedproxies|trustedproxies]] * [[doku>config:realip|realip]] * [[doku>config:proxy|proxy (host, port, user, pass, ssl, except)]] * [[doku>config:safemodehack|safemodehack]] (removed since release 2020 [[changes#release_2020-07-29a_hogfather|Hogfather]]) * [[doku>config:ftp|ftp (host, port, user, pass, root)]] (removed since release 2020 Hogfather) * **Příznaky funkcí** * [[doku>config:defer_js|defer_js]]