安装DokuWiki服务器的要求

具有PHP 支持的Web 服务器

对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 的集成环境(可任选其一)

直接下载 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已经不能再次运行，不过还是以防万一吧。