昨天开组会，老师忽然说可以搞个在线文档，以后可以保留一些东西，我就提议说可以搞个wiki，另外一个同学说可以通过docker直接搭建一个。于是组会结束就pull了一个docker，run了起来。不得不说docker确实方便多了，如果老老实实搭建会费不少时间，并且还得配置，在宿主机上面，还要考虑宿主机安装软件的情况，而用docker就屏蔽了这一切，直接run一个镜像就行了。

pull镜像

我用的是同组同学推荐的，上海大学的镜像，你也可以用官方的，都是可以的，都差不
多。这个是他们的github

docker pull shuosc/dokuwiki

拉取镜像结束，就可以run了，可以在服务器上面新建个目录，比如cd /data/wiki
然后创建一个docker-compose.yml的文件，如果服务器上面没有安装docker-compose记得安装一下apt install docker-compose。然后编辑一下docker-compose.yml文件。

version: '2'
services:
  dokuwiki:
    build: .
    image: shuosc/dokuwiki:latest
    ports:
      - 8004:80
    environment:
      - DIR=wiki
    volumes:
      - ./.data:/opt/data

接下来就是

docker-compose up -d

就可以通过http://ip:8004/wiki访问了。首先需要配置一下，所以访问http://ip:8004/wiki/install.php，这个docker有一点问题，显示的页面提示说xx文件已存在，那我们就删除他们就好了，首先进入指定目录，然后删除这三个文件，重新刷新即可。设置一下wiki的名字、管理员账号密码。安全起见，可以删掉这个install.php文件。

cd /data/wiki/.data/conf
rm local.php users.auth.php acl.auth.php

安装一些插件、模板

安装模板

可以安装一些插件、模板更方便、美观的使用wiki。首先可以去英文文档或者中文文档找到自己喜欢的，然后在“下载”按钮上面右键复制链接地址，放到下图位置即可。当然也可以搜索安装

image.png
上面的截图就是使用模板之后的样子，稍微好看一些。记得安装之后，要设置一下才能生效，设置方式如下图。
template设置

安装插件

可以安装markdown插件，MarkdownExtra Plugin可以和安装模板一样，复制链接地址进行安装。然后新建文件的时候保存后缀为.md即可。
也可以安装Add New Page Plugin插件，不然增加页面需要进入到服务器里面进行mkdir，很麻烦。

Add New Page Plugin
然后如下图所示找到wiki/welcome进行点击
sidebar
然后编辑，填入{{NEWPAGE}}然后保存即可。
NEWPAGE
接下来新建一个MD文件
MD文件
编辑MD
test
最终结果就是在根目录下创建了test目录，在test目录下创建了hello.md文件。
如果要移动目录里面的文件，还需要一个插件Move Plugin。
Move Plugin
move
然后你的文件上面就会多了一个按钮，上图中的1所示，然后点击1，通过修改2就可以移动文件了。

删除文件、目录

删除文件很简单，只要把文件里面的内容删除干净，然后保存就没了。同理删除目录也很简单，只要把目录里面的文件删除干净就行了。

ACL权限问题

ACL权限

上图中的权限设置，其中删除>上传>创建>编辑>读取>无，权限一次递减，权限可以分为个人和小组，权限，都很好理解。但是会有一个问题，就是会sidebar提示权限不够，不能创建。死活修改都不行，最后网上百度找到答案。首先可以删除路径/data/wiki/.data/data/cache(如果前面没有按照docker安装，路径可以类比一下)下面的数字和字母文件夹，然后修改一下/data/wiki/.data/lib/plugins/addnewpage目录下的syntax.php一行代码，将$renderer->info['cache'] = false;这行代码放到render函数的开头。如下图所示。

syntax.php

参考

dokuwiki学习
dokuwiki addnewpage插件无法使用问题的解决
dokuwiki addnewpage插件无法使用问题的解决 转