玩转Dokuwiki

版权声明：本文为神州灵云作者的原创文章，未经神州灵云允许不得转载。

本文作者：Joy

简介

如果说知识就是力量，那么知识库就是弹药库了。不管是一个技术型企业，还是一个热衷技术的个人，如果能有一个能够方便记录、保存以及检索的知识库，想必是极好的。如果恰好你也并没有充足的预算去购买相应的商用解决方案，那么这篇文章兴许对你有点帮助。

Dokuwiki作为一个wiki引擎，软件主体十分小巧但功能非常强大而又灵活。它语法简单，为易写性、易读性提供保障。它提供权限管理和安全策略，能够保证信息库的安全性。它又是开源的，这给熟悉PHP的开发者留下了无限的可能。它还有一个十分活跃的社区论坛，在那里能找到很多关于安装和使用的有用信息，另外，非常丰富的扩展插件也诞生于此。如果有兴趣，你也可以注册一个账号，在社区论坛里提出需求和解决别人提出的需求。
如果提供一个中小团队或者个人使用，那么Dokuwiki非常合适。

部署安装并不难

Dokuwiki的部署安装本身并不难，只需要一台安装了Web server的机器即可。如果访问量较小，哪怕是一台旧电脑都能胜任。
如果仅仅是想体验一下这套软件，那么你甚至可以在Dokuwiki的官方下载页面，选择下载版本的时候，勾选“Include Web-Server”的选项，这样就可以得到一个仅10MB左右的绿色版本MicroApache（仅供windows系统使用）。解压后，随意放在任何一个windows系统中，都可以直接运行以提供Web服务，哪怕放U盘里都是可以的。
如果你想要能够提供更多人访问，而且更稳定的Web服务，那么就需要安装全套的web server了。如果你是web开发或部署的专业人士，那么这一步对你来说真是再简单不过了。如果你不熟悉这个领域，也不必慌张，因为现在有一些集成的可以使用，一次安装即可完成所有相关软件的部署。
 Linux系统中推荐使用XAMPP。
 Windows系统中推荐使用WAMP，因为XAMPP只有32位版本供Windows使用。
安装好Web server就已经成功大半了。因为接下来的事情就很简单了。

1. 下载Dokuwiki软件包，推荐使用最新的稳定版。官方下载在此：https://www.dokuwiki.org/dokuwiki
2. 解压软件包，得到的目录放在XAMPP（假设你安装的是XAMPP）安装目录中的“htdocs”目录下。
3. 启动web server。
4. 用浏览器访问：http://IP地址:端口号/dokuwiki/install.php
5. 完成Dokuwiki的初始化配置。
   好了，一个崭新的wiki系统新鲜出炉。

开源即是为所欲为

开源让个性化定制更简单，大致有三种方法：

1. 系统配置。Dokuwiki提供了大量的配置项目，关于页面布局、颜色等等相关的个性化选项。
2. 扩展插件。Dokuwiki有庞大的插件库以供选择，选择合适的插件可以满足更广更深度的定制化需求。
3. 源码定制。熟悉PHP语言开发者的专属技能包，为所欲为吧。
4. 4？怎么还会有第4种方法？如果你看了第3条，有点小情绪，那么这一条就是来安慰你的。找到你的dokuwiki安装目录。
   a) dokuwiki/lib/tpl/dokuwiki/images/
   i. 替换logo.png来更换界面的Logo。
   ii. 替换favicon.ico来更换浏览器标签上的图标。
   b) dokuwiki/lib/tpl/dokuwiki/tpl_footer.php
   i. 修改页脚的代码都在这里，超链接和图片都能改。
   c) 增加/删除上传文件类型
   i. 用户自定义类型：dokuwiki/conf/mime.local.conf
   ii. 系统默认支持类型：dokuwiki/conf/mime.conf
   d) 修改时区：dokuwiki/inc/init.php, date_default_timezone_set(‘PRC’)
   e) Linux环境中修改上传文件大小限制
   i. /etc/php.ini文件中的upload_max_filesize
   f) Windows环境中尽管会提示上传文件过大，但好像实际并不会限制上传。
   如果你是个充满好奇心且动手能力还过得去的人，这时候再看看你的wiki界面，是不是有了大变样。如果还不能达到满意，也不必急于一时，因为这些并不影响Dokuwiki的使用，可以放在以后慢慢来。

功能很强大，使用很简单

官方使用手册，您最好的朋友：https://www.dokuwiki.org/manual
Dokuwiki本身的功能再加上数量庞大的插件，可以说非常强大了。那么问题来了，单看每一个功能都很好很强大，上手使用也很简单，不管是官方文档还是插件说明，都非常详尽完备。但面对这一切，好像有点迷茫，甚至有点慌。为了缓解这尴尬的场面，让我们来划一划重点。了解了这些，你就可以从容的构建自己的wiki知识库，至于其他的方面，可以慢慢补充。但如果重点没把握好，以后要面对的可能就不是慢慢补充了，也许是安全隐患，或者是推倒重来。

1. 给每个wiki使用者创建一个账号，并将其添加到相应的群组当中。

2. 给页面设置适当的名字空间，不同的部门或知识模块应该有不同的名字空间，不同的名字空间中页面可以重名。

3. 按名字空间设置访问权限。给不同的群组适当的访问权限设定。
   关于插件，Dokuwiki发行版本集成了一些好用且常用的，另外还有一些也推荐使用，真的是不用不知道，一用离不掉，谁用谁知道，不是开玩笑。

4. Columns Plugin：这个插件可以容易的让一个页面有多个列，这样页面空间利用的就更加紧凑，设计得当的话也会更加美观。

5. imgpaste plugin：更容易的上传图片。

6. Move plugin：重命名页面的同时，也可以修改它的名字空间，而且同时自动修改所有引用此页面的超链接。

7. ToDo：如果有个页面用来记录项目的开发目标、相关时限以及进展状态，那么这个插件也许能帮到你，值得关注。

8. Bookcreator Plugin：导出wiki的页面到文件（pdf或者text）。需要配合其他插件使用。
   a) 导出pdf文件需要同时安装”dw2pkf”插件。
   b) 导出odt文件需要同时安装“OpenDocument Export”插件。
   c) 导出text文件需要同时安装“text”插件。
   d) 详见：https://www.dokuwiki.org/plugin:bookcreator