====== 配置 DokuWiki ====== 许多 DokuWiki 功能可以通过配置不同的选项值来实现，最简单的方法是使用[[plugin:config|配置管理器]]来修改这些选项值，Wiki 管理员能用自己喜欢的网页浏览器轻松在线更改配置选项。 请用超级用户身份登录后点击**管理**按钮来启用[[plugin:config|配置管理器]]。 ===== 可配置项目有哪些 ===== DokuWiki 的“系统” 配置是在文件 ''conf/dokuwiki.php'' 中，然而这个文件只包含系统“默认”设置。如果想要定制相关项目，你可以通过编辑 ''conf/local.php'' 文件来修改相关配置值（如果文件不存在，就创建该文件）。在该文件中修改相关配置值，[[#可用选项]]参见下面说明。 用户账号，（加密）密码和访问控制规则都包含在文件[[acl|users.auth.php 和 acl.auth.php]]中。 当通过媒体管理器上传一个新文件时，可能出现 ''"上传失败。该扩展名不符合要求（被禁止!）"''的提示。这是由 ''conf/mime.conf'' 文件来控制扩展名的。要想上传新格式文件，需要先在 [[mime|mime.conf]] 文件中指定。 当你编辑页面的时候会有自动转换功能。例如生成工具条提示、笑脸表情或者特殊字符等，这些功能都是由 [[abbreviations|acronyms.conf]]、[[smileys|smileys.conf]] 和 [[entities|entities.conf]] 文件控制的。 ===== 配置文件 ===== 所有的配置文件都可以在 ''./conf'' 目录中找到，如果通过 Debian package 安装的话，配置文件目录是 ''/etc/dokuwiki'' 。 "主体文件" 通常由 DokuWiki 管理, 然而 "本地文件" 必须由维基管理员创建。 如果可以使用本地文件，你应该尽量使用本地文件而不是修改主体文件以避免升级出现问题。 ^主体文件 ^本地文件 ^配置类型 ^ 简介^ | ''dokuwiki.php'' | ''local.php''\\ ''local.protected.php'' | 见后面 | 常用 Wiki 配置信息 | | ''acronyms.conf'' | ''acronyms.local.conf'' | [[abbreviations|简写]] 自动简写提示 | | ''entities.conf'' | ''entities.local.conf'' | [[entities|实体]] | 自动文本转换 | | ''interwiki.conf'' | ''interwiki.local.conf'' | [[interwiki|WIKI 链接]] | 维基间链接简写 | | ''mime.conf'' | ''mime.local.conf'' | [[mime|媒体数据类型]] | 上传数据类型设置 | | ''smileys.conf'' | ''smileys.local.conf'' | [[smileys|笑脸]] | 图象转换 | | | ''acl.auth.php'' | 查看[[acl|权限控制]] | 权限控制设置 | | | ''users.auth.php'' | 查看[[acl|权限控制]] | 用户和密码 | | ''license.php'' | ''license.local.php'' | [[config:license|授权协议]]| 可提供协议清单 | | ''scheme.conf'' | ''scheme.local.conf'' | [[urlschemes]] | URL链接可识别模式 | | ''mediameta.php'' | ''mediameta.local.php'' | [[exif]] | 图像可编辑元数据 | | ''wordblock.conf'' | ''wordblock.local.conf'' | [[blacklist|黑名单]] | 垃圾信息黑名单 | | ''plugins.required.php'' | ''plugins.local.php''\\ ''plugins.protected.php'' | 查看后面 | 启用/关闭插件 | | | ''userscript.js'' | [[devel:javascript]] | 定制 JavaScript 增强 | | | ''userstyle.css'' | [[devel:css]] | 定制 CSS 增强 | | ''manifest.json'' | ''manifest.local.json'' | [[devel:manifest]] | PWA 清单 | ==== 主题配置文件 ==== 附加配置文件在 ''/var/lib/dokuwiki/lib/tpl/dokuwiki'' (Debian), 例如： ''[[devel:style.ini]]''。 Style.ini 是默认主题读取的文本文件，用户可以通过该文件定制主题，例如 background-color。 ===== 启用/关闭 插件 ===== 安装的插件默认为启用。当然你可以通过 [[plugin:extension|插件管理器]]关闭（该配置写在 ''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'' 控制，你可以通过修改 [[devel:preload|preload.php]] 改变其顺序。 ===== 配置选项 ===== 多数 [[DokuWiki]] 的功能都可通过配置选项来控制，最简单的方法就是利用[[plugin:config|配置管理器]]来控制。 可配置选项在后面列出。每个选项的默认值保存在 ''conf/dokuwiki.php'' 中。如果你修改了默认值，那么修改后的值会保存在 ''conf/local.php'' 中 -- 这样做是为了以后系统升级时不会覆盖掉用户的设置。配置管理器也是这样做的。文件 ''conf/local.protected.php'' 中保存的是不希望被修改的选项值。 这是一个 ''conf/local.php'' 示例： 关于配置文件需要知道：文件属于 PHP 类型文件，所以支持 PHP 语法。例如，每一行以分号结束。并且支持多种类型变量： * **Number** 数字可用，例如：''9'' * **String** 字符串需要使用单引号或者双引号引用。例如： ''%%'foo bar'%%'' * **Boolean** 布尔值可接受 ''1'' 或者 ''0'' * **Array** 数列可包含上述类型的多个值 ==== 可用选项 ==== * ** 基本设置 ** * [[config:title]] * [[config:startpage|start]] * [[config:lang]] * [[config:template]] * [[config:tagline]] * [[config:sidebar]] * [[config:license]] * [[config:savedir]] * [[config:basedir]] * [[config:baseurl]] * [[config:cookiedir]] * [[config:dmode]] * [[config:fmode]] * [[config:allowdebug]] * ** 显示设置 ** * [[config:recent]] * [[config:recent_days]] * [[config:breadcrumbs]] * [[config:youarehere]] * [[config:fullpath]] * [[config:typography]] * [[config:dformat]] * [[config:signature]] * [[config:showuseras]] * [[config:toptoclevel]] * [[config:tocminheads]] * [[config:maxtoclevel]] * [[config:maxseclevel]] * [[config:camelcase]] * [[config:deaccent]] * [[config:useheading]] * [[config:sneaky_index]] * [[config:hidepages]] * ** 验证设置 ** * [[config:useacl]] * [[config:autopasswd]] * [[config:authtype]] * [[config:passcrypt]] * [[config:defaultgroup]] * [[config:superuser]] * [[config:manager]] * [[config:profileconfirm]] * [[config:rememberme]] * [[config:disableactions]] * [[config:auth_security_timeout]] * [[config:securecookie]] * [[config:remote]] * [[config:remoteuser]] * ** 反垃圾信息设置 ** * [[config:usewordblock]] * [[config:relnofollow]] * [[config:indexdelay]] * [[config:mailguard]] * [[config:iexssprotect]] * ** 编辑设置 ** * [[config:usedraft]] * [[config:htmlok]] * [[config:phpok]] * [[config:locktime]] * [[config:cachetime]] * ** 链接设置 ** * [[config:target|target (wiki, interwiki, extern, media, windows)]] * ** 多媒体设置 ** * [[config:mediarevisions]] * [[config:gdlib]] * [[config:im_convert]] * [[config:jpg_quality]] * [[config:fetchsize]] * [[config:refcheck]] * ** 通知设置 ** * [[config:subscribers]] * [[config:subscribe_time]] * [[config:notify]] * [[config:registernotify]] * [[config:mailfrom]] * [[config:mailreturnpath]] * [[config:mailprefix]] * [[config:htmlmail]] * ** 供稿设置 ** * [[config:sitemap]] * [[config:rss_type]] * [[config:rss_linkto]] * [[config:rss_content]] * [[config:rss_media]] * [[config:rss_update]] * [[config:rss_show_summary]] * [[config:rss_show_deleted]] * ** 高级设置 ** * [[config:updatecheck]] * [[config:userewrite]] * [[config:useslash]] * [[config:sepchar]] * [[config:canonical]] * [[config:fnencode]] * [[config:autoplural]] * [[config:compress]] * [[config:cssdatauri]] * [[config:gzip_output]] * [[config:send404]] * [[config:compression]] * [[config:broken_iua]] * [[config:xsendfile]] * [[config:renderer_xhtml]] * [[config:readdircache]] * [[config:search_nslimit]] * [[config:search_fragment]] * ** 网络设置 ** * [[config:dnslookups]] * [[config:jquerycdn]] * [[config:proxy|proxy (host, port, user, pass, ssl, except)]] * [[config:trustedproxy]] * [[config:safemodehack]] (removed since release 2020 Hogfather) * [[config:ftp|ftp (host, port, user, pass, root)]] (removed since release 2020 Hogfather) * ** 功能标志 ** * [[config:defer_js]]