搭建 DokuWiki

发表于 2021-03-08 更新于 2021-03-21 分类于折腾阅读次数：

教练最近想搭建一个校内分享套路知识的 Wiki ，找我帮忙，正好我对此比较感兴趣，就折腾了一下。

我先是了解了各种不同的 wiki ，著名的 OI-Wiki 使用的是 MkDocs ，它的搭建十分简单，但并不是我想要的：我认为它更适合于个人站点搭建，因为普通用户无法直接地修改 Wiki 页面，要达到自由修改的目的就不得不借助 Git 等工具，即使如此编辑起来也较为麻烦，这无疑增加了操作难度和管理难度。

维基百科使用的是 MediaWiki ，但用 MediaWiki 搭建校内分享的网站似乎有些许“大材小用”，其过于重量级了。

总之最后我看中了 DokuWiki ，虽然我仍然认为其不够轻量，但它似乎至少能满足我的预期。

安装

最推荐的教程自然是官网¹。笔者因为从野鸡教程开始学习搭建而走了不少弯路（话说本教程也算是野鸡教程吧）。

首先需要 php ，特别需要注意的是目前 DokuWiki 并不支持 PHP8 。

然后需要一个 web 服务的软件，我使用的是 apache² ，然后配置好 PHP 。

笔者最初使用的是 php-fpm ，但后来遇到了一些问题（似乎是 php-fpm.conf 的问题），换成 libphp 就好了。

如果你的 php 版本是 8.x.x 且不愿意降级（比如我这种版本更新强迫症），那就需要额外下载 php7 相关软件，并时刻注意区分 php 和 php7 。

一般的安装方式是下载官网提供的压缩包并解压到指定目录（比如 /srv/http ），我最开始也的确是尝试的这个方法。但是看了官网发现 Manjaro 自带 DokuWiki 的包³后就果断放弃了。

首先 yay -S dokuwiki ，然后在 apache 的配置文件里添加 Include conf/extra/dokuwiki.conf 。

然后需要 chown -R http:http /var/lib/dokuwiki/ 和 chown -R http:http /usr/share/webapps/dokuwiki 更改目录权限。

最后打开 http://localhost/dokuwiki/install.php 即可安装。

插件

登录管理员帐号，点击右上角管理，进入扩展管理器即可安装插件。

有趣的是 DokuWiki 的每个大版本都有一个对应的英文名⁴，比如最新版本是 "Hogfather" ，其次是 "Greebo" ，如果碰到这些词汇请注意。

Markdowku: 使得编辑器支持 Markdown 语法。
MathJax: 使得编辑器支持数学公式。