Table of Contents

配置 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 默认按照以下顺序加载配置文件：

  1. conf/plugins.php – 默认插件
  2. conf/plugins.local.php – 通过插件管理器更改的插件
  3. conf/plugins.required.php – 这些核心插件不受插件管理器控制
  4. 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 语法。例如，每一行以分号结束。并且支持多种类型变量：

可用选项