开源Wiki——Dokuwiki的安装与配置

  • 十月 29,2017
  • Coding

命运真是奇怪的很,写上篇博客的时候我还是一个软件研发工程师,现在我就告别了开发工作,变成了一个天天跑现场的实施。虽然如此,还是把上一个职位时所作的一点微弱的工作记录下来,不求有人看,就当留个念想吧。

当时领导给了个小任务,要我搭一个CAA的代码库,方法不限。灵机一动,想到了Wiki的方式,这样既可以上传代码附件,也可以写代码说明,各个例程的组织结构也比较清晰。于是百度了一发,找到了这个轻量级的Wiki库,Dokuwiki,具体优点有:

  • 容易安装和使用

  • 系统要求低

  • 内置访问控制列表

  • 种类丰富的扩展

  • 支持多达50种语言

  • 设备无关

  • 开源

其实,当初选择Dokuwiki,最重要的原因是无需数据库,所有的wiki页面都以txt的形式保存了下来。作为一个很小的知识共享平台,搭建起来很容易,而且很方便备份和维护(比如我走了,很简单的就移交给了宽哥)。另外,插件众多,算是方便。

安装

Dokuwiki的安装十分简单,去官网下载,可以根据自己的需要勾选语言和一些常用插件,然后点击Start Download即可。下载下来的是一个压缩包,解压即可。

由于我是在Windows环境下使用,还需要搭建Apache和Php环境,方便起见,直接选择一个WAMP集成环境即可。Dokuwiki官网上有一些推荐,包括UniServer、WampServer、XAMPP和easyPHP等。这里选择的是XAMPP。到XAMPP官网下载软件并安装,这部分很简单,不再赘述。

安装好XAMPP后,将解压好的Dokuwiki文件复制到“XAMPP安装目录\htdocs”路径下,然后打开XAMMP控制面板,开启Apache(仅需该服务),然后打开浏览器,输入http://localhost/dokuwiki,如果出现下图,就说明安装成功了。

配置

安装成功后,可以输入http://localhost/dokuwiki/install.php,设置wiki的基本信息、管理员账户以及开源协议,如图所示。

另外值得一说的是插件和主题的配置。插件在官网的Plugins页下载,并解压到“XAMPP安装目录 \ htdocs \ dokuwiki \ lib \ plugins ”下,并在wiki的拓展管理器中选择启用或停用。主题在官网的Extension页下载,并解压到“XAMPP安装目录 \ htdocs \ dokuwiki \ lib \ tpl ”,并在wiki的配置管理器中选择即可。下面推荐几个主题和插件。

主题:

  • Vector:仿维基百科的风格。

  • Bootstrip3:Bootstrip风格,个人比较喜欢,如下图所示。

插件:

  • SimpleNavi:默认的Wiki没有侧边栏,安装这个插件后可以自动生成一个简单的侧边栏。

  • Wrap:必装,增强排版功能。

  • Discussion:评论功能,需要先安装Pagelist插件。

  • Tag:提供标签功能,如上图右上角所示。

  • MathJax:可以使用Latex语言写公式。

  • Avatar:为用户提供头像功能。

  • Imgpaste:在Chrome浏览器中,可以直接粘贴图片,免去了上传附件的步骤。

  • Move:可以移动或重命名页面并保持各自的连接关系。

其他还有很多插件,大家可以根据自己的需要自行尝试~

CONTACT