差别

这里会显示出您选择的修订版和当前版本之间的差别。

--- zh:config [2022-09-19 05:12] – 219.145.19.148
+++ zh:config [2023-02-16 03:10] (当前版本) – 已恢复为旧版 (2021-05-17 14:57) yzqzss
@@ 行 1: / 行 1: @@
-这是我的DokuWiki
+====== 配置 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'' 示例：
+<code php>
+<?php
+$conf['title']     = "Admin's Wiki. ";
+$conf['useacl']    = 1;
+$conf['superuser'] = 'admin';
+</code>
+关于配置文件需要知道：文件属于 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]]