当前位置: 首页 > 文档资料 > Dokuwiki 中文教程 >

Dokuwiki 介绍及 Window 安装

优质
小牛编辑
132浏览
2023-12-01

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