目录
DokuWiki 的安装环境
安装 DokuWiki 对服务器的要求
- 具有 PHP 支持的 Web 服务器
- 首选 Apache
- 对 PHP 的要求
- 基于某些 安全考虑 强烈建议使用 PHP 4.3.10 及其以上的版本
- 使用 libGD 2 的PHP's GD extension — 可选项
- 建议运行于 PHP 的 Safe Mode
- 建议运行于 PHP 的 register_globals=off 模式.
- DokuWiki 默认使用文本文件存储数据,无需数据库支持。
- DokuWiki 默认使用文本文件存储用户认证信息,也可以配置 DokuWiki 使用其他的用户认证信息存储方式
DokuWiki 的包结构
DokuWiki 的下载地址
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- 标有“*”的文件一般无需改动
- 标有“**”的文件可以根据需要进行编辑
对于一般用户而言,如下目录及文件很重要:
- conf/ 目录下的配置文件,这些文件在安装过程中自动生成
- acl.auth.php
- local.php
- users.auth.php
- data/ 目录下的文本和图片目录
- pages/ – 存放 wiki 文本文件
- media/ – 存放 wiki 中引用的站内图片等
- lib/ 目录下的模板和插件目录
- plugins – 可以使用 Dokuwiki 的管理界面安装、更新、删除
- tpl – 由用户直接上传要使用的模板
DokuWiki 运行时要保证:
- Web 服务器对
data/和data/tmp/目录及其子目录可写 - Web 服务器对
lib/plugins/子目录可写以便使用插件管理器 - Web 服务器对
conf/local.php文件可写以便使用浏览器安装系统或日后更改配置 - Web 服务器对
conf/users.auth.php和conf/acl.auth.php文件可写以便使用浏览器安装系统或日后更改用户的 ACL 配置
如果上传用户不是 Web 服务器进程的用户需要适当调整权限。
参考 wiki:install:permissions
准备 DokuWiki 的安装环境
DokuWiki on Windows
在 Windows 环境下要运行 Dokuwki,您可以:
- 下载、安装基于 Apache 的集成环境(可任选其一)
- 下载、安装基于 Lighttpd 的集成环境(可任选其一)
- 配置 IIS+PHP
- 若您已经在 Windows 上配置了支持 PHP 的 Web 服务器可以直接用于 DokuWiki 的安装
- 若您还未安装 Web 服务器且不打算运行其他基于数据库的 CMS,建议使用轻量级的 LightyPHP
在 Windows 下要安装 Dokuwiki ,一般需要如下的准备工作:
- 配置支持 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 on CentOS/RHEL
例如:在 CentOS 5.1 下要安装 Dokuwiki ,一般需要如下的准备工作:
安装 Apache2+PHP5
# yum install httpd # yum install php php-common php-cli php-pear # yum install php-gd php-imap php-mbstring php-mcrypt
配置 Apache
# echo "Include vhost.d/*.conf" >> /etc/httpd/conf/httpd.conf # mkdir /etc/httpd/vhost.d # echo "NameVirtualHost *" > /etc/httpd/vhost.d/NameVirtualHost.conf # vim /etc/httpd/vhost.d/mytest-net.conf
<VirtualHost *>
ServerAdmin webmaster@localhost
ServerName www.mytest.net
# ServerName wiki.mytest.net
DocumentRoot /www/mytest.net
# DocumentRoot /www/mytest.net/dokuwiki
<Directory /www/mytest.net/>
# <Directory /www/mytest.net/dokuwiki/>
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Order allow,deny
allow from all
</Directory>
ServerSignature On
</VirtualHost># service httpd restart
下载 DokuWiki
# mkdir -p /www/mytest.net # cd /www/mytest.net # wget 'http://www.splitbrain.org/_media/projects/dokuwiki/dokuwiki-2008-05-05.tgz?id=projects%3Adokuwiki&cache=cache' # mv 'dokuwiki-2008-05-05.tgz?id=projects:dokuwiki&cache=cache' dokuwiki-2008-05-05.tgz # tar -xzf dokuwiki-2008-05-05.tgz # mv dokuwiki-2008-05-05 dokuwiki # chown -R apache.apache dokuwiki
DokuWiki on Ubuntu/Debian
例如:在 ubuntu 8.04 下要安装 Dokuwiki ,一般需要如下的准备工作:
安装 Apache2+PHP5
$ sudo apt-get update $ sudo apt-get install apache2 apache2-mpm-prefork $ sudo apt-get install php5 php-pear php5-cli php5-gd php5-imap php5-common $ sudo apt-get install php5-mcrypt php5-mhash php5-syck php5-xmlrpc php5-xsl $ sudo apt-get install libapache2-mod-php5
配置 Apache
$ sudo vim /etc/apache2/sites-available/mytest-net
<VirtualHost *>
ServerAdmin webmaster@localhost
ServerName www.mytest.net
# ServerName wiki.mytest.net
DocumentRoot /www/mytest.net
# DocumentRoot /www/mytest.net/dokuwiki
<Directory />
Options FollowSymLinks
AllowOverride None
</Directory>
<Directory /www/mytest.net/>
# <Directory /www/mytest.net/dokuwiki/>
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Order allow,deny
allow from all
</Directory>
LogLevel warn
ErrorLog /var/log/apache2/error.log
CustomLog /var/log/apache2/access.log combined
ServerSignature On
</VirtualHost>$ sudo ln -s /etc/apache2/sites-available/mytest-net /etc/apache2/sites-enabled/010-mytest-net $ sudo a2enmod php5 rewrite $ sudo /etc/init.d/apache2 restart
下载 DokuWiki
$ sudo mkdir -p /www/mytest.net $ cd /www/mytest.net $ sudo wget 'http://www.splitbrain.org/_media/projects/dokuwiki/dokuwiki-2008-05-05.tgz?id=projects%3Adokuwiki&cache=cache' $ sudo mv 'dokuwiki-2008-05-05.tgz?id=projects:dokuwiki&cache=cache' dokuwiki-2008-05-05.tgz $ sudo tar -xzf dokuwiki-2008-05-05.tgz $ sudo mv dokuwiki-2008-05-05 dokuwiki $ sudo chown -R www-data.www-data dokuwiki
DokuWiki on a hosted server
SSH login
$ cd <站点根目录的上一级目录> $ wget 'http://www.splitbrain.org/_media/projects/dokuwiki/dokuwiki-2008-05-05.tgz?id=projects%3Adokuwiki&cache=cache' $ tar -xzf dokuwiki-2008-05-05.tgz $ mv dokuwiki-2008-05-05 dokuwiki
在 Control Panel 配置 dokuwiki 的虚拟主机目录时:
FTP only
- 下载 最新版的 DokuWiki
- 将下载文件
dokuwiki-YYYY-MM-DD.tgz解压到本地目录 - 上传文件至服务器的 Web 文档根目录
- 参照上述 Dokuwiki 目录结构说明部分修改文件、目录权限
- 若您希望以
http://wiki.mytest.net域名访问 WIKI 站,将dokuwiki-YYYY-MM-DD目录里的内容上传到 Web 文档根目录 - 若您希望以
http://mytest.net/dokuwiki域名访问 WIKI 站,首先将dokuwiki-YYYY-MM-DD目录改名为dokuwiki,然后将dokuwiki目录上传到 Web 文档根目录







