搭建 DokuWiki

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

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

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

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

安装

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

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

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

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

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

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

首先 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 的每个大版本都有一个对应的英文名4,比如最新版本是 "Hogfather" ,其次是 "Greebo" ,如果碰到这些词汇请注意。

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

  1. install (DokuWiki)↩︎

  2. Apache HTTP Server - ArchWiki↩︎

  3. DokuWiki - ArchWiki↩︎

  4. changes (DokuWiki)↩︎