只需分分钟，给自己和团队搭建个简单易用却强大的Wiki，适合中小团队和个人

Posted 2021-07-28 阿迷创客

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了只需分分钟，给自己和团队搭建个简单易用却强大的Wiki，适合中小团队和个人相关的知识，希望对你有一定的参考价值。

文章目录

1. 卷首语

小团队的文档，如何高效编写，并方便维护？
系统要免费，且容易搭建，选择谁？
不使用SQL数据库存储

许多人的答案，必定是dokuwiki!

本文介绍搭建dukowiki的方法，实现了wiki的常用功能，如用户管理、邮件提醒、权限管理、分组权限管理、文章授权等等相当实用的功能的配置方法。希望大家喜欢！

2. 环境介绍

OS: ubuntu 16.04
Apache/2.4.18 (Ubuntu)
php7.0
Wiki: dokuwiki-stable 版本，使用类似markdown语法

3. 安装命令

3.1 一连串安装命令

$sudo apt-get update
$sudo apt-get install apache2 libapache2-mod-php php-xml
$sudo a2enmod rewrite
$cd /var/www
$sudo wget https://download.dokuwiki.org/src/dokuwiki/dokuwiki-stable.tgz
$sudo tar xvf dokuwiki-stable.tgz
$sudo mv dokuwiki-*/ dokuwiki
$sudo chown -R www-data:www-data /var/www/dokuwiki

3.2 配置apache2站点根路径

$sudo vim /etc/apache2/sites-enabled/000-default.conf 

DocumentRoot /var/www/html
改为：
DocumentRoot /var/www/dokuwiki

3.3 配置apache2的目录权限

sudo vim /etc/apache2/apache2.conf

找到 directory /var/www/ 
将：
AllowOverride None
修改为：
AllowOverride All

3.4 重启apache2，使配置生效

sudo service apache2 restart

3.5 执行web安装程序

打开浏览器
输入服务器地址：http://IP-address-of-your-server/install.php
按需求做下系统配置，例如管理员用户名、WIKI名称、是否允许用户注册等等

3.6 邮件发送功能

如需邮件发送功能，执行下面命令，选择Internet Site选项，即可，就这么简单！

sudo apt-get install postfix

测试邮件是否能发送成功

echo "hello " | mail -s "邮件发送测试"  yourname@youremail.com

之后到yourname@youremail.com的邮箱中，查看是否有收到邮件

4. 创建文章

4.1 简要说明

如下图所示，创建文章只需要修改URL的后最即可，目录层级使用冒号分隔，最后跟上文章名字
之后敲入回车，并点击右侧按钮，选择创建此文章

4.2 帮助页面-Markdown语法说明

访问：192.168.103.74/doku.php?id=wiki:syntax 即可查看到下图语法页面
点击【右上角】->【站点地图】即显示下面画面

5. 群组配置

5.1 修改ACL配置文件

类似Linux的Group，可以给不同Group的用户，以不同的访问权限。此功能我查询了很久，只有下面这个方法，能创建自定义的Group

szhou@server_01:/var/www/dokuwiki$ sudo vim conf/acl.auth.php

打开conf/acl.auth.php文件后，如下所示，按格式添加了android和sqa群组，名称需要使用全小写

# acl.auth.php
# <?php exit()?>
# Don't modify the lines above
#
# Access Control Lists
#
# Auto-generated by install script
# Date: Fri, 18 Jun 2021 08:55:59 +0000
*       @ALL    1
*       @user   0
*       @android        8
*       @sqa    1
~                                                                                                                                                                                                                                                                                                                                                                                 
"conf/acl.auth.php" 12L, 206C