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

引言

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

  • 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

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

发表于

我来说两句

0 条评论
登录 后参与评论

相关文章

来自专栏zhangdd.com

WordPress浏览次数统计插件:WP-PostViews Plus

wp-postviews-plus,该插件可以统计每篇文章的浏览次数,根据展示次数显示历史最热或最衰的文章排行、展示范围可以是全部文章和页面,并且启用插件后自动...

1091
来自专栏林欣哲

10 分钟看懂分布式事务

什么是分布式事务 问题的引出 先看一张图,一个电商平台的架构图。 ? 对于用户来说的一个创建订单的过程,背后很可能跨越了多个应用服务。涉及诸如:订单、库存、...

3815
来自专栏Django Scrapy

Elasticsearch1.0 介绍

优势 开源,稳定,快速,可扩展 由 Java开发 基于 restful web接口与服务器交互的分布式搜索引擎 搜索引擎除了elasticsearch还有 s...

2875
来自专栏北京马哥教育

大神教你DIY高性能运维堡垒体系

概述 不怕出问题,就怕出问题找不到原因 运维团队一般会有个需求就是记录运维或者开发同事在服务器上的操作记录,比如进行一些常规审核或者是服务器被黑了、服务器日志被...

4846
来自专栏coding

pyenv,让你轻松切换各种python版本

8376
来自专栏linux驱动个人学习

systemd的作用

早上群上讨论了一下systemd的作用,还导致了一个人的直接退群,出于求知心理,搜索了一些systemd,对此也作出了一些相应的整理; 一、systemd的诞生...

4507
来自专栏北京马哥教育

【图文并茂】一步步带你了解Web站点架构

1.1 http反向代理服务器 在web站点前端,我们需要搭建一个反向代理服务器,用于负责接受用户的请求,请求包括动态和静态的内容请求。一般反向代理服务器的部署...

4888
来自专栏微服务生态

缓存穿透、缓存并发、缓存失效之思路变迁

我们在用缓存的时候,不管是Redis或者Memcached,基本上会通用遇到以下三个问题:

1484
来自专栏zhisheng

听说你要做网站

现代 Web 后端技术超入门 引言 现在房价这么高,作为一个程序员只能靠做个网站看能不能卖出 100 万这样搏一手了。这里尝试介绍一下现代 Web 后端并解释一...

3828
来自专栏程序员互动联盟

浏览器开发系列第四篇:windows下如何调试最新chromium源码

接二连三的事情,时间比较紧张,但是还是没有把这个系列的文章丢掉,因为这也是对自己知识的总结吧。提倡大家多写写,以后再看的时候会有种莫名的小激动。 上周写的是ch...

3998

扫码关注云+社区

领取腾讯云代金券