玩转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
    玩转Dokuwiki_第1张图片

你可能感兴趣的:(玩转Dokuwiki)