这是本文档旧的修订版！

本站的Dokuwiki设置

本文是该wiki的安装配置说明，Dokuwiki主页有详细的manual，这里只简要列出处理步骤。

操作系统基于CentOS 6，当前的Web服务器为Apache 2.4，Dokuwiki版本为2017-02-19e “Frusterick Manners”。

升级说明

升级Apache和PHP

新的Dokuwiki要求PHP 5.6以上，所以需要先升级Apache和PHP。

启用scl源：

yum install centos-release-scl

安装新版本的Apache和PHP：

yum install httpd24
yum install rh-php56 rh-php56-php

启用新服务：

chkconfig httpd off
chkconfig httpd24-httpd on

Apache配置调整

新的Apache目录发生了改变，所以需要做相应调整。

编辑/opt/rh/httpd24/root/etc/httpd/conf/httpd.conf，添加：

<Directory /opt/rh/httpd24/root/var/www/html/wiki>
    Order deny,allow
    Allow from all
</Directory>
 
<LocationMatch "/wiki/(data|conf|bin|inc)/">
    Order allow,deny
    Deny from all
    Satisfy All
</LocationMatch>

Dokuwiki升级

首先将原来的wiki文件复制到新位置：

cd /opt/rh/httpd24/root/var/www/html
cp -pr /var/www/html/* .

如果间隔了多个版本，需要依次升级。

升级到2015-08-10a “Detritus”：

tar xzvf dokuwiki-2015-08-10.tgz
'cp' -af dokuwiki-2015-08-10/* wiki/

升级到2016-06-26e “Elenor of Tsort”：

tar xzvf dokuwiki-2016-06-26.tgz
'cp' -af dokuwiki-2016-06-26/* wiki/

升级到2017-02-19e “Frusterick Manners”：

tar xzvf dokuwiki-2017-02-19.tgz
'cp' -af dokuwiki-2017-02-19/* wiki/

最后调整权限：

chown -R apache:apache wiki/
chmod -R o-rwx wiki/

Plugin插件升级

在扩展管理器里更新各个插件。

初始安装

Web服务器为Apache 2.2，Dokuwiki版本为2014-05-05a “Ponder Stibbons”。

web服务器配置

为了安全性，对Dokuwiki的几个关键目录进行设置。

在/etc/httpd/conf/httpd.conf末尾添加：

<Directory /var/www/html/wiki>
    Order deny,allow
    Allow from all
</Directory>
 
<LocationMatch "/wiki/(data|conf|bin|inc)/">
    Order allow,deny
    Deny from all
    Satisfy All
</LocationMatch>

有关Dokuwiki安全方面的详细说明，可参阅http://www.dokuwiki.org/security。

Dokuwiki安装

解包

wiki程序安装在web服务器目录/var/www/html下，并将文件权限归属为web服务器进程用户（apache）：

cd /var/www/html
tar xzf dokuwiki-*.tgz
mv dokuwiki wiki
chown -R apache:apache wiki/
chmod -R o-rwx wiki/

有关Dokuwiki权限方面的详细说明，可参阅http://www.dokuwiki.org/install:permissions。

初始配置

通过浏览器运行install.php，进行初始配置，包括设置语言、wiki名称、管理员帐户、wiki类型、license等。

完毕以管理员帐户登录，添加一个日常应用的普通帐户；设置目录权限为0750，文件权限为0640；由于是个人wiki，关闭注册功能。

Template模板设置

有关模板的详细说明，可参阅http://www.dokuwiki.org/Template。

这里直接使用缺省的模板。

Plugin插件设置

Dokuwiki提供了丰富的插件，有关插件的详细说明，可参阅http://www.dokuwiki.org/plugins。

插件通过扩展管理器直接安装。

安装完毕，若插件没有效果，则更新下缓存：

touch /var/www/html/wiki/conf/local.php

有关缓存问题的详细说明在：http://www.dokuwiki.org/devel:caching#purging_the_cache。

目前使用的插件：

Note, http://www.dokuwiki.org/plugin:note
Tag, http://www.dokuwiki.org/plugin:tag
Cloud, http://www.dokuwiki.org/plugin:cloud
Pagelist, http://www.dokuwiki.org/plugin:pagelist
Code2, http://www.dokuwiki.org/plugin:code2
Table Width, http://www.dokuwiki.org/plugin:tablewidth