配置 DokuWiki

许多 DokuWiki 功能可以通过配置不同的选项值来实现，最简单的方法是使用配置管理器来修改这些选项值，Wiki 管理员能用自己喜欢的网页浏览器轻松在线更改配置选项。

请用超级用户身份登录后点击管理按钮来启用配置管理器。

可配置项目有哪些

DokuWiki 的“系统” 配置是在文件 conf/dokuwiki.php 中，然而这个文件只包含系统“默认”设置。如果想要定制相关项目，你可以通过编辑 conf/local.php 文件来修改相关配置值（如果文件不存在，就创建该文件）。在该文件中修改相关配置值，可用选项参见下面说明。

用户账号，（加密）密码和访问控制规则都包含在文件users.auth.php 和 acl.auth.php中。

当通过媒体管理器上传一个新文件时，可能出现 “上传失败。该扩展名不符合要求（被禁止!）”的提示。这是由 conf/mime.conf 文件来控制扩展名的。要想上传新格式文件，需要先在 mime.conf 文件中指定。

当你编辑页面的时候会有自动转换功能。例如生成工具条提示、笑脸表情或者特殊字符等，这些功能都是由 acronyms.conf、smileys.conf 和 entities.conf 文件控制的。

配置文件

所有的配置文件都可以在 ./conf 目录中找到，如果通过 Debian package 安装的话，配置文件目录是 /etc/dokuwiki 。

“主体文件” 通常由 DokuWiki 管理, 然而 “本地文件” 必须由维基管理员创建。

如果可以使用本地文件，你应该尽量使用本地文件而不是修改主体文件以避免升级出现问题。

主体文件	本地文件	配置类型	简介
`dokuwiki.php`	`local.php` `local.protected.php`	见后面	常用 Wiki 配置信息
`acronyms.conf`	`acronyms.local.conf`	简写自动简写提示
`entities.conf`	`entities.local.conf`	实体	自动文本转换
`interwiki.conf`	`interwiki.local.conf`	WIKI 链接	维基间链接简写
`mime.conf`	`mime.local.conf`	媒体数据类型	上传数据类型设置
`smileys.conf`	`smileys.local.conf`	笑脸	图象转换
	`acl.auth.php`	查看权限控制	权限控制设置
	`users.auth.php`	查看权限控制	用户和密码
`license.php`	`license.local.php`	授权协议	可提供协议清单
`scheme.conf`	`scheme.local.conf`	urlschemes	URL链接可识别模式
`mediameta.php`	`mediameta.local.php`	exif	图像可编辑元数据
`wordblock.conf`	`wordblock.local.conf`	黑名单	垃圾信息黑名单
`plugins.required.php`	`plugins.local.php` `plugins.protected.php`	查看后面	启用/关闭插件
	`userscript.js`	javascript	定制 JavaScript 增强
	`userstyle.css`	css	定制 CSS 增强
`manifest.json`	`manifest.local.json`	manifest	PWA 清单

主题配置文件

附加配置文件在 /var/lib/dokuwiki/lib/tpl/dokuwiki (Debian), 例如： style.ini。 Style.ini 是默认主题读取的文本文件，用户可以通过该文件定制主题，例如 background-color。

启用/关闭插件

安装的插件默认为启用。当然你可以通过插件管理器关闭（该配置写在 plugins.local.php 文件里）。你可以将某些插件放置到 conf/plugins.protected.php 以将其保护起来。

DokuWiki 默认按照以下顺序加载配置文件：

conf/plugins.php – 默认插件
conf/plugins.local.php – 通过插件管理器更改的插件
conf/plugins.required.php – 这些核心插件不受插件管理器控制
conf/plugins.protected.php – 通过其他文件里进行了重置

配置文件的加载顺序是通过全局变量 $config_cascade 控制，你可以通过修改 preload.php 改变其顺序。

配置选项

多数 DokuWiki 的功能都可通过配置选项来控制，最简单的方法就是利用配置管理器来控制。

可配置选项在后面列出。每个选项的默认值保存在 conf/dokuwiki.php 中。如果你修改了默认值，那么修改后的值会保存在 conf/local.php 中 – 这样做是为了以后系统升级时不会覆盖掉用户的设置。配置管理器也是这样做的。文件 conf/local.protected.php 中保存的是不希望被修改的选项值。

这是一个 conf/local.php 示例：

<?php
$conf['title']     = "Admin's Wiki. ";
 
$conf['useacl']    = 1;
$conf['superuser'] = 'admin';

关于配置文件需要知道：文件属于 PHP 类型文件，所以支持 PHP 语法。例如，每一行以分号结束。并且支持多种类型变量：

Number 数字可用，例如：9
String 字符串需要使用单引号或者双引号引用。例如： 'foo bar'
Boolean 布尔值可接受 1 或者 0
Array 数列可包含上述类型的多个值

可用选项

基本设置
- title
- start
- lang
- template
- tagline
- sidebar
- license
- savedir
- basedir
- baseurl
- cookiedir
- dmode
- fmode
- allowdebug
显示设置
- recent
- recent_days
- breadcrumbs
- youarehere
- fullpath
- typography
- dformat
- signature
- showuseras
- toptoclevel
- tocminheads
- maxtoclevel
- maxseclevel
- camelcase
- deaccent
- useheading
- sneaky_index
- hidepages
验证设置
反垃圾信息设置
编辑设置
- usedraft
- htmlok
- phpok
- locktime
- cachetime
链接设置
- target (wiki, interwiki, extern, media, windows)
多媒体设置
通知设置
供稿设置
高级设置
- updatecheck
- userewrite
- useslash
- sepchar
- canonical
- fnencode
- autoplural
- compress
- cssdatauri
- gzip_output
- send404
- compression
- broken_iua
- xsendfile
- renderer_xhtml
- readdircache
- search_nslimit
- search_fragment
网络设置
- dnslookups
- jquerycdn
- proxy (host, port, user, pass, ssl, except)
- trustedproxy
- safemodehack (removed since release 2020 Hogfather)
- ftp (host, port, user, pass, root) (removed since release 2020 Hogfather)
功能标志
- defer_js

目录