1==== Configuration files ====
2
3All configuration files are to be found in the ''./conf'' folder or ''/etc/dokuwiki'' when installed from a Debian package.
4
5"Main files" usually ship with DokuWiki, whereas "local files" have to be created by the wiki admin.
6
7If local files are supported you should use them instead of modifying the main files to avoid upgrade troubles.
8
9
10^ main file                 ^ local file                                         ^ type of config             ^ quick info                             ^
11| ''dokuwiki.php''          | ''local.php''\\ ''local.protected.php''            | see [[doku>config#configuration_options|config]] | general wiki configuration             |
12| ''acronyms.conf''         | ''acronyms.local.conf''                            | [[doku>abbreviations]]     | automatic abbreviation hints           |
13| ''entities.conf''         | ''entities.local.conf''                            | [[doku>entities]]          | automatic text replacements            |
14| ''interwiki.conf''        | ''interwiki.local.conf''                           | [[doku>interwiki]]         | interwiki shortcut links               |
15| ''mime.conf''             | ''mime.local.conf''                                | [[doku>mime]]              | mime type settings for uploads         |
16| ''smileys.conf''          | ''smileys.local.conf''                             | [[doku>smileys]]           | image replacements                     |
17|                           | ''acl.auth.php''                                   | see [[doku>acl]]           | Access Control settings                |
18|                           | ''users.auth.php''                                 | see [[doku>acl]]           | Users and passwords                    |
19| ''license.php''           | ''license.local.php''                              | [[doku>config:license]]    | list of available licenses             |
20| ''scheme.conf''           | ''scheme.local.conf''                              | [[doku>urlschemes]]        | URL schemes to be recognized as links  |
21| ''mediameta.php''         |                                                    | [[doku>exif]]              | Metadata editable for images           |
22| ''wordblock.conf''        | ''wordblock.local.conf''                           | [[doku>blacklist]]         | Spam blacklist                         |
23| ''plugins.required.php''  | ''plugins.local.php''\\ ''plugins.protected.php''  | see [[doku>config#enabling_disabling_plugins|config]] | Enabling/disabling plugins             |
24|                           | ''userscript.js''                                  | [[doku>devel:javascript]]  | Custom JavaScript enhancements         |
25|                           | ''userstyle.css''                                  | [[doku>devel:css]]         | Custom CSS enhancements                |
26