====== 在 Gandi AI 安装 DokuWiki  ======
DokuWiki 的应用服务很广, 可以让你在自己的网站建立一个 wiki, 事实上, 就是你现在看到的这个 wiki. :)

有一件很棒的事情就是他使用文字档来储存资料，所以你不需要安装 MySQL 资料库.

===== 建立资料夹 Creating a directory =====

等等！先在这边做个选择，你希望使用 "子目录" 的方式安装, 例如 wiki 是安装在 **www** 底下(%%www.example.com/wiki%%) 或是你希望使用 "子网域" 的方式安装, 例如 (wiki.example.com)


==== 如果你选择使用 子目录 的方式安装 ====

简单! 只要确认你建立了一个资料夹来存放(例如是: %%www.example.com/wiki%%)

==== 如果你选择使用 子网域 的方式安装, 例如: wiki.example.com ====

有两个步骤需要完成:

  *在伺服器上设定你的子网域, 可参考 [[zh:hosting:gandi-ai:configure-virtualhosts|教学]].
  *将子网域指向你设定的伺服器, 可参考 [[zh:hosting:manage-quota:attach-domain|教学]].

This is the option we will be using in the rest of the tutorial.

===== 下载 DokuWiki =====

首先, 我们需要下载压缩安装档, 在编写本文件同时, 最新的版本是 1.0.14.

当然从官方网站下载安装压缩档最好, 因此, 我建议从这 [[http://www.splitbrain.org/projects/dokuwiki|下载]]

现在你已经下载完成了, 请解压缩. 你现在应该有一个资料夹包含了所有 DokuWiki 的档案(请将他重新命名为 **wiki**)

执行你的 FTP 软体(我们建议使用 [[http://sourceforge.net/project/showfiles.php?group_id=21558&package_id=15149&release_id=568040|FileZilla]], 并且使用帐号 **admin** 登入你的伺服器. 打开你之前在虚拟站台内定义好的路径.

在我们的范例中, FTP 的路径如下:

  /srv/d_my-gandai-ai/www/wiki.example.com/htdocs

如上, 除非你有修改过 Web 的设定档, 不论如何, 你必须知道你的路径位置. :)

在这个步骤, 请上传 DokuWiki 的安装档案到您的伺服器

  * 如果你是使用 **wiki.example.com** 的虚拟站台, 并且直接使用网址连接(不是使用子目录的方式), 请将 **wiki** 资料夹内(不包含 wiki 这个目录)的东西上传到 **htdocs** 
  * 如果你比较喜欢 **example.com/wiki** 的方式, 请将整个 wiki 资料夹上传到 **htdocs** 内


===== 准备工作 =====

安装 DokuWiki 前的一些设定, 某些目录与档案必须调整权限. 一般来说, 你可以直接用 FTP 软体来操作, 你唯一要做的事情就是在档案上或资料夹上面点选右键(可能是右键, CHMOD, 属性...). 假设你使用 FileZilla, 以下是操作方式:

在档案上面按滑鼠右键并且选择 "**档案属性(File Attribute...)**". 软体会开启一个是视窗并提供您两个方法来变更权限: 勾选属性或是输入数值

在这里我们使用输入数值的方式变更, 它就跟 UNIX 的方式像同, 请 **输入 777 来覆蓋旧值**.

**wiki** 资料夹中, 以下资料夹都需要调整权限:

  /conf
  /data 
  /data/attic
  /data/cache
  /data/index
  /data/media
  /data/meta
  /data/locks
  /data/pages


===== 安装 DokuWiki =====

使用你的浏览器, 打开 DokuWiki 中的 **install.php** 页面, 在我们的范例中是: wiki.example.com/install.php

如果 DokuWiki 的档案都正确上传, 并且如上述调整好权限后, 你应该可以看到一个页面要求你填入下列资料!

**Wiki Name**: 随你的喜好修改

**Enable ACL (recommended)**: 建议使用预设的设定

**Superuser**:  输入 wiki 的管理者帐号

**Full name**: 管理者的全名

**E-Mail**: 你/妳 的 EMail

**Password**: 你/妳 的密码

**once again**: 再次输入 你/妳 的密码

**Initial ACL policy**: 选择 "开放" 你的 wiki 页面

----

完成! 如果你想知道更多关于 DokiWiki 的细节, 请参阅  [[http://wiki.splitbrain.org/wiki:installer|官方文件]].