美文网首页程序员iOS 技术文档收录
简单免费的文档中心——dokuWiki搭建指南

简单免费的文档中心——dokuWiki搭建指南

作者: nimomeng | 来源:发表于2016-10-15 11:42 被阅读17697次

    引言

    最近因为项目需要,团队需要一个轻量级的文档中心。调研了一下,方案有以下几种:

    • Confluence:最有名,最强大,最通用,最老牌,Atlassian,公司级的wiki就是这货。缺点是团队超过10人用时需要付费,而且价格不菲。:( 忍痛Pass
    • Jekyll:著名开源博客工具,大有取代WordPress的趋势,部署相对简单,插件强大,完全免费。缺点是貌似只能够通过和Git交互来新建和更新文章,没有自带的编辑页面。
    • Dokuwiki:简单,轻量,支持PHP即可使用,插件丰富,权限控制强大,完全免费,有编辑页面,不懂代码也可以使用。缺点是缺乏对Markdown的原生支持(即使装了插件,也无法完全解析Markdown)

    因此对比一番,果断选择Dokuwiki作为文档中心。

    安装

    首先去官网下载页面下载最新版本的Dokuwiki,根据自己需要动态打包,不需要安装:

    下载页面

    开启web容器

    笔者环境是Mac,因此下文以mac为例。其它系统参考Dokuwiki的install页面.

    Mac系统由于自带了apache,所以打开即可。先输入

    sudo apachectl -v
    

    查看系统apache版本,确认apache确实存在:

    apache

    确定apache确实存在之后,启动apache服务器:

    sudo apachectl start
    

    怎样验证apache服务器确实启动了呢?在浏览器输入“http://localhost”,如果发现“It Works!”的字眼,则说明系统成功启动。

    apache index page

    如何修改服务端口?
    打开Finder,进入/etc/apache2/httpd.conf目录(cmd+Shift+G),编辑httpd.conf文件,找到

    Listen 80
    

    一行,改成你想要的端口即可。

    至此,web 容器启动完成。

    部署

    Mac下Apach的DocumentRoot目录是/Library/WebServer/Documents,将dokuwiki解压缩后的文件夹拷入。

    在termial输入php -v查看php版本。如果没有,请参照PHP安装教程安装PHP

    在确定PHP已经安装的前提下,修改PHP文件配置:打开/etc/apache2/httpd.conf文件,查找#LoadModule php5_module,去掉前面的注释(#号),保存,退出。
    重启Apache

    sudo apachectl stop
    sudo apachectl start
    

    至此部署过程完成

    配置

    打开浏览器,输入http://localhost/dokuwiki/install.php,进入dokuwiki的配置页面。
    如果遇到页面提示说dokuwiki权限存在问题,如下图所示:

    Dokuwiki存在权限问题的提示

    则需要修改dokuwiki的文件夹权限,修改方法为,在terminl中输入:

    sudo chmod -R 777 dokuwiki所在目录(包含dokuwiki)
    

    权限设置好后,重新刷新浏览器页面,如果出现如下界面,说明部署dokuwiki成功:

    dokuwiki
    配置项根据自己需要填写即可。
    install页面输入完成后,即可正式进入dokuwiki页面了。
    浏览器中输入http://localhost/dokuwiki/即可正式开启Dokuwiki之旅。
    Dokuwiki

    迁移时可能遇到的问题

    如果迁移Dokuwiki时遇到了

    The datadir ('pages') at ./data/pages is not found, isn't accessible or writable.
    

    的问题,修改dokuwiki相应目录权限即可。

    如果在Ubuntu下运行时发现打开install.php显示的确实php源码,说明php运行环境没有准备好,这时请查看Ubuntu版本,并且参考Dokuwiki的install指导进行安装配置。笔者这里是Ubuntu 16.04, PHP7,因此需要安装

    sudo apt-get install apache2 libapache2-mod-php7.0
    

    下一次可以写一篇有关Dokuwiki的plugin和部署到其他系统的文章。
    EOF

    相关文章

      网友评论

        本文标题:简单免费的文档中心——dokuWiki搭建指南

        本文链接:https://www.haomeiwen.com/subject/dqhgyttx.html