使用dokuwiki部署一个美观的知识库（可能是全网最完善的）

两个小黄鹂

已于 2024-07-04 11:27:53 修改

阅读量1.4w

点赞数 33

分类专栏：操作系统 # Linux 文章标签： apache php linux

于 2022-03-13 19:56:48 首次发布

本文链接：https://blog.csdn.net/u014650965/article/details/123358011

版权

操作系统同时被 2 个专栏收录

19 篇文章

订阅专栏

Linux

17 篇文章

订阅专栏

本文指导如何在Linux下安装XAMPP 7.4.27，配置Apache用户，部署并个性化DokuWiki，包括安装插件如IndexMenuPlugin与Bootstrap3模板，以及解决常见问题。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

安装XAMPP

需要安装7版本PHP，对应安装XAMPP的7版本
下载xampp-linux-x64-7.4.27-2-installer.run

##创建apache用户
useradd -s /sbin/nologin -M apache
chmod +x xampp-linux-x64-7.4.27-2-installer.run
./xampp-linux-x64-7.4.27-2-installer.run

部署完成后可能是daemon用户，重启apache服务

./xampp restartapache

安装dokuwiki

下载dokuwiki-24117f7f9e0362c4b1782ff29220b0ab.tgz到/tmp目录，解压
htdocs默认是xampp的家目录

cd /opt/lampp/htdocs
tar -xvf /tmp/dokuwiki-24117f7f9e0362c4b1782ff29220b0ab.tgz
chown -R apache:apache dokuwiki

初始化dokuwiki

根据需要进行设定，右侧有设定语言的选项，可以选择zh，设定未中文

在这里插入图片描述

安装插件

1. 扩展管理

离线环境需要到dokuwiki官网下载插件或模板，如果有网络可以直接进入管理-》扩展管理器安装需要的插件或模板，待整个环境调整完再迁移到离线环境

在这里插入图片描述

2. 插件安装

网络环境直接选择搜索安装，离线环境点击手动安装，这里主要说离线模式

在这里插入图片描述

3. 手动安装

选择对应的插件及模板进行安装，下载地址就是官网
https://www.dokuwiki.org/plugins

在这里插入图片描述

4. 插件卸载关闭

插件安装完成后可以在现有插件进行查看，可以卸载或关闭

在这里插入图片描述

插件及模板介绍

下面是下载的所有插件及模板

在这里插入图片描述

Add New Page

ckgedit

不建议使用ueditor，除非自己能完全调通，或者确实需要他的功能，放上链接

https://www.jianshu.com/p/c567b23f6702

目前发现的好用的比较实用的编辑器，也尝试了ueditor（百度开源的编辑器），但是部署上之后，无法显示文章的目录，不是太方便，再者系统主要用来记录技术文章，编辑器功能即使很强大，但是意义不是太大，反而是文章目录这个在使用时更有意义。

在这里插入图片描述

EditTable plugin

在这里插入图片描述

imgpaste plugin

可以直接复制图片到编辑器

Indexmenu Plugin

显示页面索引

Move plugin

修改页面或目录名称

在这里插入图片描述

Bootstrap3 Template

这是目前个人比较中意的模板

在这里插入图片描述

下面三个插件时安装bootstrap3模板需要的，具体作用不详

Structured Data Plugin
sqlite plugin
Fastwiki Plugin

插件设置

IndexMenu Plugin

这个插件比较重要，但是问题也多，需要进行适当的配置

1. 设置页面索引

网站地图->wiki->welcome->sidebar->创建该页面
下面两个任选一个，第二个比较漂亮

{{indexmenu>..#1|msort}}
{{indexmenu>:#1|js#leopard.png navbar tsort msort nsort}}

2. defer_js设置

Indexmenu Plugin: If you use the ‘js’-option of the indexmenu plugin, you have to disable the ‘defer_js’-setting. This setting is temporary, in the future the indexmenu plugin will be improved.

管理->配置设置->defer_js->取消勾选->保存

3. HTTPClient.php问题

Warning: require_once(/opt/lampp/htdocs/dokuwiki/inc/HTTPClient.php): failed to open stream: No such file or directory in /opt/lampp/htdocs/dokuwiki/lib/plugins/indexmenu/admin.php on line 364
Fatal error: require_once(): Failed opening required ‘/opt/lampp/htdocs/dokuwiki/inc/HTTPClient.php’ (include_path=‘.:/opt/lampp/lib/php’) in /opt/lampp/htdocs/dokuwiki/lib/plugins/indexmenu/admin.php on line 364

编辑文件，修改364行的数据如下

vim /opt/lampp/htdocs/dokuwiki/inc/HTTPClient.php
require_once (DOKU_INC.'inc/HTTP/HTTPClient.php');

3. 跳过命名空间及页面

管理->Indexmenu->skip_index

/（ |playground|wiki|）/

管理->Indexmenu->skip_file

/（|sidebar|）/

在这里插入图片描述

4. 去除红箭头

注释background这一行

vim /opt/lampp/htdocs/dokuwiki/lib/plugins/indexmenu/style.css
/*tocbullet property*/
.dtree .indexmenu_tocbullet {
	position: absolute;
	/*background: transparent url(images/toc_bullet.gif) no-repeat scroll;*/
	vertical-align: middle;
	width: 11px;
	height: 11px;
}