安装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已经不能再次运行,不过还是以防万一吧。