php的开源wiki主要有:

mediawiki：php

dokuwiki:php

############################################################

安装apache2和php:

sudo apt-get install apache2 libapache2-mod-php5
参考apache的配置。

安装dokuwiki:

sudo a2enmod rewrite
sudo cp –a doku… /var/www/
cd /var/www
tar zxvf doku… -C dokuwiki
chown -R www-data:www-data /var/www/dokuwiki

修改路径:

sudo vi /etc/apache2/sites-enabled/000*.conf

DocumentRoot/var/www/html → DocumentRoot /var/www/dokuwiki

修改权限:

sudo vi /etc/apache2/apache2.conf
： Allow Override None → AllowOverride All

重启apache2:

sudo service apache2 restart

在web安装:

http://IP-address-of-your-server/install.php toinitially configure your DokuWiki.

安装完成后删除：

sudo rm /var/www/dokuwiki/install.php

安全设置:

data conf bin inc 这四个目录是不能通过web（http和https）访问的。

在/etc/apache2/apache2.conf或/usr/local/conf/httpd.conf添加下面配置：

#允许访问/var/www/dokuwiki/目录

order deny,allow

allow from all

#禁制访问/var/www/dokuwiki/(data|conf|bin|inc)/目录

<locationmatch "="" (data|conf|bin|inc)="">

order allow,deny

deny from all

satisfy all

############################################################

doku的配置：

doku的配置文件在/var/www/dokuwiki/conf/

主文件通常由dokuwiki管理，局部文件由管理员创建。

也就是我们需要创建并修改局部的local文件来配置。

dokuwiki.php:主配置文件

local.php:局部文件

local.protected.php：保护不受更改

plugins.php：默认插件

plugins.local.php：插件管理员修改

plugins.required.php：核心插件

plugins.protected.php：覆盖设置

user.auth.php：用户账号密码

acl.auth.php：访问控制规则

mediameta.php：可编辑的元数据

license.php：可用的许可证

mime.conf：上传文件的规则

acronyms.conf：自动缩进提示

smileys.conf：图像补充

entities.conf：文本补充

interwiki.conf：快捷方式

scheme.conf：url方案

wordblock.conf：垃圾邮件列表

############################################################

dokuwiki的插件和模板管理：

手动安装就是下载解压到下面路径然后chown为www-data：

/var/www/dokuwiki/lib/tpl用来安装模板

/var/www/dokuwiki/lib/plugins用来安装插件

自动安装就是在dokuwiki的web页面的模板管理安装。

前期准备：yum 安装httpd和mysql

1.下载罪行dokuwiki安装包 http://download.dokuwiki.org/；

2.centos系统中httpd的根目录为：/var/www/html (摸索了很长时间，非常重要的信息)，将安装包解压到该目录（默认文件夹名为dokuwiki）；

3.设置权限，chown -R apache：apache dokuwiki （权限组名apache的信息比较重要，试错了好几次）；

4.在浏览器中输入：local_IP/dokuwiki (注意：服务器上最好设置静态路由，该步奏网上信息较多，略)

5.安全设置，将data、conf文件夹移除，按该网址提示：https://www.dokuwiki.org/zh:security

遇到的问题：

1.其他笔记本初次登录local_IP/dokuwiki显示无连接（电脑重启之后也需进行同样的操作）

解决步奏：

首先，ping IP 通；其次，telnet IP 80，不通；

原因出自防火墙将80端口屏蔽。

解决办法：

/sbin/iptables -I INPUT -p tcp –dport 80 -j ACCEPT

/etc/rc.d/init.d/iptables save

/etc/init.d/iptables restart

进阶：

1.设置模板，将现在的包（模板地址：https://www.dokuwiki.org/zh:template#lightbox/3/）解压到/lib/tpl，然后就可以在设置中选择自己想要的模板了。

2.注册新用户，无需将密码通过邮箱发送。在设置选项中将自动产生密码的一项的钩去掉。

3.阅读语法：https://www.dokuwiki.org/zh-tw:syntax，了解文本编辑技巧。

语法：

dokuwiki的编辑

在实践中遇到问题、解决问题

PS：越来越发现博客不适合做知识库了，因为文章之间太分散，条理也不清晰。明显没有wiki那么清楚明了，wiki就和思维导图一样，看着那些结构层次命令的，就能回忆个大概，所以搭建了这个wiki知识库，供个人使用，以后可能会考虑开放吧。又要学习一遍wiki的语法了。

dokuwiki安装与配置
1.下载dokuwiki网站源码
#wget -c  http://download.dokuwiki.org/src/dokuwiki/dokuwiki-stable.tgz

2.解压源码安装
#tar -zvxf dokuwiki-stable.tgz    //解包解压缩
#cd dokuwiki-2013-05-10a   //进入解压后的目录
#cp -R * /home/www   //复制解压的网站源码文件到网站根目录

在浏览器输入：http://域名或者ip/install.php

xxx is not writable by DokuWiki. You need to fix the permission settings of this directory!

The installer found some problems, indicated below. You can not continue until you have fixed them.

{DOCUMENT_ROOT}/data/pages is not writable by DokuWiki. You need to fix the permission settings of this directory!
{DOCUMENT_ROOT}/data/attic is not writable by DokuWiki. You need to fix the permission settings of this directory!
{DOCUMENT_ROOT}/data/media is not writable by DokuWiki. You need to fix the permission settings of this directory!
{DOCUMENT_ROOT}/data/media_attic is not writable by DokuWiki. You need to fix the permission settings of this directory!
{DOCUMENT_ROOT}/data/media_meta is not writable by DokuWiki. You need to fix the permission settings of this directory!
{DOCUMENT_ROOT}/data/meta is not writable by DokuWiki. You need to fix the permission settings of this directory!
{DOCUMENT_ROOT}/data/cache is not writable by DokuWiki. You need to fix the permission settings of this directory!
{DOCUMENT_ROOT}/data/locks is not writable by DokuWiki. You need to fix the permission settings of this directory!
{DOCUMENT_ROOT}/data/index is not writable by DokuWiki. You need to fix the permission settings of this directory!
{DOCUMENT_ROOT}/data/tmp is not writable by DokuWiki. You need to fix the permission settings of this directory!

 

这是因为文件和文件夹权限问题，修改权限就可以了：
#chown -R www:www /home/www   //将文件所有者由root用户改为www用户(你nginx运行的用户)

先在右上角选好语言，简体中文zh
填写好网站的名称，管理员等，协议等

安装完后，为了安全，要删除install.php文件，然后再用刚才设置的用户名密码登陆

关于安全：

http://你的域名或者ip/data/pages/wiki/dokuwiki.txt

如果你能通过上面这个链接，访问到dokuwiki.txt文件，那么表明你的网站的数据是不安全，因为dokuwiki是文本数据库，也就是别人可以直接拖库了。

官方要求是

• data
• conf
• bin
• inc

这四个目录是不能通过web访问浏览的，所以，我们要设置这些目录的权限，保证网站的数据安全。

解决办法：因为这个根据你的web服务器的不同而设置访问权限的方式也不同，所以，我下面会贴出大部分web 服务器的设置方法。

• nginx

我的就是nginx，在网站的nginx.conf配置文件的server段加上下面的代码：

location ~ /(data|conf|bin|inc)/

{

deny all;

}

或者通过.htaccess文件禁止访问：

location ~ /\.ht {

deny all;

}

• Apache

用.htaccess文件来禁止，格式如下：

order allow,deny

deny from all

注意：官方说apache2的.htaccess文件在ubuntu上失效，所以，方法特别，需要进入/etc/apache2/sites-available，修改default文件(如果你是用的 https，这是修改default-ssl )

NameVirtualHost *
<VirtualHost *>
ServerAdmin admin@site.com

DocumentRoot /var/www/
<Directory />
Options FollowSymLinks
AllowOverride None
</Directory>
<Directory /var/www/>
Options Indexes FollowSymLinks MultiViews
AllowOverride none
Order allow,deny
allow from all
</Directory>

将其中的 AllowOverride none 改为  AllowOverride all ，然后重启apache服务器

或者直接在VirtualHost文件里，用LocationMatch ，代码如下：

<LocationMatch “/(data|conf|bin|inc)/”>
Order allow,deny
Deny from all
Satisfy All
</LocationMatch>

但是，可能会导致比如你的另外一个网站跟目下也有data，conf这类目录也不能访问，方法如下，扩展下

locationmatch：
<Directory /var/www/dokuwiki>
order deny,allow
allow from all
</Directory>

<LocationMatch “/dokuwiki/(data|conf|bin|inc)/”>
order allow,deny
deny from all
satisfy all
</LocationMatch>

• IIS

进入刚才所提到的目录，进行如下设定：

1. 打开配置工具: 开始 → 设置 → 控制面板 → 管理工具 → Internet信息服务
2. 进入到你要保护的目录: 本地计算机 → 网站 → 默认web站点→ 目录路径
3. 右击文件夹并选中属性 →目录安全 → IP address and domain name restrictions (ip地址和域名限制)→ Edit（编辑）…
4. 选择“默认情况下，所有计算机：禁止访问”

在IIS7:

1. select “IIS Request Filtering”
2. go to the “URL” tab
3. click on “Deny Sequence”
4. enter ”/data/” in the popup box

Repeat for ”/data/media” and choose “Always Allow” (otherwise your images and other won’t be visible)

Note: By default, the Management Console snap-in for Internet Information Services 7 does not have UI access to “IIS Request Filtering” section. However, can be enabled by installing “IIS Administration pack 1.0” by using the Web Platform Installer.

Also note: Ensure you enter ”/data/” and NOT just ”/data”, otherwise pages that start with “data” will be inaccessible.

• Lighttpd

• Cherokee(据说比nginx还快的web 服务器，大家可以去试试.但貌似不如nginx稳定)

TMD，其他的重命名，迁移data目录什么的，懒得翻译了，贴上官方的文档地址：https://www.dokuwiki.org/security#web_access_security       自己有疑问就去看吧，不懂google翻译去。

DokuWiki是一款简洁轻便，代码整洁，功能强大而灵活的开源Wiki程序。尤其适用于中小团队和个人网站知识库的管理。可以预见，在声名鹊起的web2.0风潮中，DokuWiki必将更会广泛应用。

主要内容：
一、下载与简介
二、实践与技巧
三、杂乱的资料

一、下载与简介
==========
是一个知识管理工具。wiki的。
下载地址是：
http://www.splitbrain.org/blog/2008-05/16-dokuwiki_on_a_stick_2008-05-05
(这个版本的比较简单，后面就是用的这个)
官方：
http://www.splitbrain.org/projects/dokuwiki

二、实践与技巧
==========
我在windows上面的使用过程：
*安装:
1）在http://www.splitbrain.org/blog/2008-05/16-dokuwiki_on_a_stick_2008-05-05下载
2）解压，看README
3）根据README进行如下过程：
3.1)运行mapache.exe
这样弹出一个dos窗口，不要关闭它。
3.2)在浏览器上面敲入如下网址：http://localhost:8800/
之后自己慢慢学习。
3.3)想要退出就运行stop.exe.

*创建一个新的页面:
方法1)想要创建一个新的不存在的页面，要先访问它，提示不存在才能创建。例如：http://localhost:8800/playground/new 提示没有这个页面然后创建它。也可以创建目录，再创建页面，只需事先访问它。

方法2)在搜索框里面搜索 :playground:bad:new 这个不存在的页面，然后在结果中点创建该页面，就可以创建那个相应目录下面的页面了。目录用unix目录结构表示，是/playground/bad/new 。这里貌似直接使用/playground/bad/new进行搜索也行，或者使用bad/new会自动定位到相应的地方的。
如果再搜索playground/bad/new/haha并且创建，也不会覆盖原来的new,而是另外又新建立一个new目录。

方法3）手动在dokuwiki\data\pages目录下面创建相应的目录或者文件，然后dokuwiki会自动地将它们映射成页面和namespaces的。

)使用pagemove插件可以移动和创建.注意目录要使用类似linux的绝对路径

*删除一个页面
保存一个空的页面，那么这个页面会自动删除，如果一个目录下面没有页面了，那么这个目录也被删除。
似乎手动在dokuwiki\data\pages创建一个新的目录不会被删。

三、杂乱的资料
============
下面是杂乱的学习资料：
start主页
Welcome to your DokuWiki on a Stick
This is a DokuWiki install combined with a minimal Apache server preconfigured to run from an USB stick. The Apache/PHP setup is based on the MicroApache project.
This install comes with a precreated superuser. Login with admin/admin to access the DokuWiki administration backend. Be sure to change the password!
If you want to save some space on your stick you can delete languages you don’t need from dokuwiki/inc/lang/ and dokuwiki/lib/plugins/*/lang/.
Have fun!
以上的主要内容是：
DokuWiki安装的时候，可以从USB盘上面启动，需要的配置Apache非常之少。
安装的时候，预先创建了一个超级用户，使用admin/admin来进入DokuWiki管理后台。请记住要修改这个密码！
如果你想要节省一些空间，那么你可删除dokuwiki/inc/lang/和dokuwiki/lib/plugins/*/下面的你不需要的东西。

*如何添加一个新的条目或者目录分类？
尝试了一下，在
D:\Program Files\DokuWikiStick\dokuwiki\data\pages
添加目录或者文件可以显示出来，但是不知道这样是不是正规的途径。

*如何备份DokuWiki?
http://www.dokuwiki.org/zh:faq:backup?s[]=backup
由于 DokuWiki 不使用数据库，备份是很简单的。您需要做的就是拷贝所有的文件。最简单的方法就是备份您的整个 DokuWiki 目录。
如果您想要节约一些空间，您至少需要备份下列目录：
data/pages
data/meta
data/media
conf

常用的插件：
http://sinosmond.com/guide/dokuwiki/dokuwiki_plugin#常用的插件
http://www.dokuwiki.org/plugins

一些技巧
http://www.ichiayi.com/wiki/tech/dokuwiki_tips

官方网址：
http://www.dokuwiki.org/dokuwiki
在线文档：
http://www.dokuwiki.org/
一个图形化的安装过程：
http://www.dokuwiki.org/install:screencast
下载网址：
http://www.splitbrain.org/projects/dokuwiki

安装过程：
比较好的参考网址：
http://www.dokuwiki.org/install
http://sinosmond.com/guide/dokuwiki/dokuwiki_install

最简过程：
1）下载最新dokuwiki
下载网址：
http://www.splitbrain.org/projects/dokuwiki
这里我下载的是：
dokuwiki-2009-12-25c.tgz

2）解压文件dokuwiki-2009-12-25c.tgz：
$tar -xzvf dokuwiki-2009-12-25c.tgz

3）配置安装环境：
3.1)sudo apt-get install apache2 apache2-mpm-prefork
3.2)sudo apt-get install php5 php-pear php5-cli php5-gd php5-imap php5-common
这里，应该就可以访问dokuwiki了。
如果安装之后不好使，就重启一下apache:/etc/init.d/apache2 restart，如果还是不好使，就再安装下面两个：
$ sudo apt-get install php5-mcrypt php5-mhash php5-syck php5-xmlrpc php5-xsl
$ sudo apt-get install libapache2-mod-php5

4)拷贝dokuwiki-2009-12-25c目录里面的内容到web地址空间：
$sudo cp dokuwiki-2009-12-25c /var/www
这里，/var/www下面只有一个index.html如果在你的浏览器中敲入你的ip地址，会自动打开这个页面。/var/www是apache2的默认web地址空间，这个地址在/etc/apache2/sites-available/default里面应该有所指定，更多的配置需要了解apache配置相关的知识这里不多说了。在拷贝之前，删除这个index.html。

5)初始配置dokuwiki:
在浏览器输入：http://<你的ip地址>/install
这里，注意，我曾经输入过”http://<你的ip地址>/install.php”总是提示保存php文件，怎么走不通后来输入了http://<你的ip地址>/install就好了。
注意，这里刚开始不要直接输入”http://<你的ip地址>”，因为这样不会自动进入install的安装界面，而是进入dokuwiki的最简界面，之后如果再想安装可能就会提示已经有了某某文件无法继续了，为了出现这个情况，最好第一次就运行
http://<你的ip地址>/install.

安装DokuWiki服务器的要求

• 具有PHP 支持的Web 服务器
• 首选Apache
• 对PHP的要求
• 基于某些安全考虑强烈建议使用PHP 4.3.10及其以上的版本
• 使用libGD2 的PHP’s GD 扩展 — 可选项
• 建议运行于PHP的 Safe Mode
• 建议运行于PHP的 register_globals=off 模式.

DokuWiki 的目录结构

dokuwiki
|-- bin
|-- conf                        ---  存放配置文件
|   |-- acl.auth.php.dist         --- acl.auth.php（ACL 控制配置文件）的默认发布 *
|   |-- acronyms.conf             --- 用于定义首字母缩写词，以便当鼠标移动到这些词时显示解释信息
|   |-- dokuwiki.php              --- DokuWiki 的主配置文件 *
|   |-- entities.conf             --- 用于定义实体字符 **
|   |-- interwiki.conf            --- 用于定义 interwiki，以便使用简单的方式书写 URL **
|   |-- local.php.dist            --- local.php（本地配置文件）的默认发布 *
|   |-- mediameta.php             --- 定义用于 media manager 的 meta data 配置 *
|   |-- mime.conf                 --- 定义 mimetypes 的配置文件 *
|   |-- msg                       --- 一个标志文件，用于判断当前版本是否为最新 *
|   |-- mysql.conf.php.example    --- mysql.conf.php（mysql 用户认证的配置文件）的默认发布 *
|   |-- smileys.conf              --- 用于定义“笑脸”的配置文件 *
|   |-- users.auth.php.dist       --- users.auth.php（文本用户认证的配置文件）的默认发布 *
|   |-- wordblock.conf            --- 用于配置不允许书写的 URL **
|   `-- words.aspell.dist         --- words.aspell（拼写检查配置文件）的默认发布 *
|-- data                        ---  存放文档数据
|   |-- attic                     ---  存放版本信息
|   |-- cache                     ---  数据缓存
|   |-- index                     ---  存放内部索引
|   |-- locks                     ---  用于存放编辑页面时的锁定文件
|   |-- media                     ---  存放图片等
|   |-- meta                      ---  存放 meta 以便系统读取这些信息生成页面
|   |-- pages                     ---  存放 wiki 页面
|   `-- tmp                       ---  临时目录
|-- inc                         ---  DokuWiki 的 Include 目录
|   |-- auth                      --- 存放不同方式的用户认证脚本
|   |-- geshi                     --- 使用 geshi 进行代码加亮显示
|   |-- lang                      --- 多语言支持
|   |   |-- en
|   |   |-- fr
|   |   |-- zh
|   |   `-- zh-tw
|   `-- parser                    --- DokuWiki 的核心解析器
`-- lib
    |-- exe
    |-- images
    |-- plugins                   ---  存放插件的目录
    |   |-- acl
    |   |-- config
    |   |-- importoldchangelog
    |   |-- info
    |   |-- plugin
    |   `-- usermanager
    |-- scripts
    |-- styles
    `-- tpl                       ---  存放模版的目录
        `-- default

DokuWiki安装在Windows 上

在Windows环境下要运行Dokuwki，你可以：

• 下载、安装基于Apache 的集成环境（可任选其一）
  • xampp
  • Appserv

• 直接下载 Apache、PHP，安装之后配置 Apache+PHP

安装步骤

• 配置支持PHP的Web服务器
• 下载 最新版的DokuWiki
• 将下载文件dokuwiki-YYYY-MM-DD.tgz 解压
• 复制内容到Web文档根目录

小贴士：

若你希望以http://wiki.mytest.net 域名访问WIKI站，将dokuwiki-YYYY-MM-DD 目录里的内容复制到Web文档根目录

若您希望以http://mytest.net/dokuwiki 域名访问WIKI站，首先将dokuwiki-YYYY-MM-DD 目录改名为dokuwiki，然后将dokuwiki目录复制到Web文档根目录

Dokuwiki安装

Dokuwiki的安装是很简单的，无需修改任何文件，只需要解压缩然后填入一些基本信息就可以了。当然，这在很大程度上和它不需要数据库有关。想想如果要MySQL，那要增加多少步骤。

下载

在官方网站下载最新的稳定版：http://www.splitbrain.org/projects/dokuwiki ，然后解压缩到你的网站目录下，比如/var/www/dokuwiki。

修改权限

修改权限以使Web服务器对文件有相应的读写权限。

• 对于Linux系统，假设Web服务器的用户和组是www-data，那么执行

sudo chown www-data:www-data -R /var/www/dokuwiki

• 如果是Windows的系统，可以右键打开文件夹的属性，找到“权限”选项卡，然后对Web服务器的用户组赋予相应权限。（这是XP的操作。VIsta和Win7没用过，不知道改没改）

安装

现在在浏览器中输入地址，比如http://localhost/dokuwiki ，应该可以看到Dokuwiki的界面了。如果出现错误，一般是权限有问题。不过这并不是装好了，你还没有自己的账户，也不能进行任何配置。

要真正完成安装，在浏览器中输入，比如http://localhost/dokuwiki/install.php ，这会打开安装页面。先在右上角的“Choose your language”后面的下拉列表中选择“zh”，将页面变成中文。

现在开始安装配置：

• 维基名称：你wiki的名字，比如我的是Lainme’s Blog
• 启用ACL（推荐）：即启用权限控制，这个保持默认（选中状态）
• 超级用户：输入超级用户的用户名
• 全名：超级用户的全名，和上一个一样就行
• E-Mail：超级用户的电子邮件地址
• 密码：超级用户的密码
• 请再输一次：再次输入密码
• 初始的ACL政策：全局权限控制策略，在下拉列表中选择一个合适的
  • 开放的维基（任何人都有读、写、上传的权限）
  • 公开的维基（任何人都有读的权限，只有注册用户才有写和上传的权限）
  • 关闭的维基（只有注册用户才有读、写、上传的权限）

填写完成后按“保存”完成安装。现在再次进入http://localhost/dokuwiki ，可以在右下角看到有个“登录”按钮，同时标题栏也变成了你设定的网站名称。

为了安全，最好删除目录下的install.php文件。虽然Dokuwiki自身也有保护，install.php已经不能再次运行，不过还是以防万一吧。

只是一个列表和简要的功能介绍，具体使用看相关文档

主题

Vector是模仿Wikipedia/Mediawiki最新样式的主题，自定义比较能力强。另外其实Dokuwiki现在的默认主题非常不错，也很适合写博客。

如果希望自己写，可以参考这里的文档以及Dokuwiki提供的一个初始模板

插件

外观

• wrap：几乎涵盖大多数外观、排版上的要求。

交互

• discussion：添加评论功能，需要pagelist插件的支持。
• disqus: 添加评论功能，使用 DISQUS 的服务。
• avatar：使用gravatar头像，多用于评论里的头像显示
• captcha：验证码

标签

• tag：用标签来组织内容
• tagentry：在编辑栏下提供所有标签的列表，方便选择
• cloud：标签云

导航

• indexmenu：功能强大。但我不喜欢它默认的样式，又懒得去改。
• indexmenu2：功能也不错，相对indexmenu略微逊色点
• pagequery：前面两个主要用于生成树状结构的导航，这个完全不一样，非常值得一看。
• simpleindex: 生成类似内置索引的简单导航，仅适用于顶层命名空间。
• simplenavi: 生成一个简单的导航。

其他

• mathjax：使用mathjax的公式插件
• refnotes：文献管理与引用，很灵活很强大，配置上有些复杂。
• zotero：从zotero引用文献
• imagereference：类似mediawiki那样给图片加题注并引用。
• NumberedHeadings：给标题编号

还有很多看起来非常不错的，例如画图、化学、图片/视频浏览等，不过自己没用过。