====== 在 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-tw:hosting:gandi-ai:configure-virtualhosts|教學]].
  *將子網域指向你設定的伺服器, 可參考 [[zh-tw: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|官方文件]].