最近因为项目需要,团队需要一个轻量级的文档中心。调研了一下,方案有以下几种:
因此对比一番,果断选择Dokuwiki作为文档中心。
首先去官网下载页面下载最新版本的Dokuwiki,根据自己需要动态打包,不需要安装:
下载页面
笔者环境是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