====== 在 Gandi Simple Hosting 來安裝 DokuWiki ======

這篇教學是給在 Gandi Simple Hosting 上安裝 DokuWiki 的人。



==== 安裝步驟 ====


=== 下載 DokuWiki 安裝包 ===

首先是從 [[http://www.splitbrain.org/projects/dokuwiki|官方連結]] 下載壓縮安裝包。

{{ en:hosting:using-linux:tutorials:simple:screen-shot-2012-05-27-at-9.59.51-pm.png?w=400&nolink }}

完成下載後請解壓縮檔案。

=== 上傳檔案 ===

接下來，請上傳解壓縮資料夾**內**的所有檔案(請不要包含資料夾本身)，到您的伺服器。

<note tip>
**用子網域的方式安裝** (例如: ''%%wiki.example.com%%''): 
如果您想用 "%%wiki.example.com%%" 的方式存取 wiki, 您需要 [[:zh-tw:simple:shs-dns_config#add-a-virtualhost-to-your-instance|建立一個虛擬伺服器]] (vhost) 並取名為 "%%wiki.example.com%%"

一旦您使用 sFTP 連接上機器, 您需要 [[:zh-tw:simple:sftp|上傳]] DokuWiki 內的檔案目錄到 "htdocs/": 
</note>

{{ en:hosting:using-linux:tutorials:simple:sh-directory-tree.png?nolink }}

<note tip>
**使用子目錄的方式**(例如: ''%%www.example.com/wiki%%''): 
如果您想用 ''%%www.example.com/wiki%%'' 的方式存取 wiki, 您需要 [[:zh-tw:simple:shs-dns_config#add-a-virtualhost-to-your-instance|建立一個虛擬伺服器]] (vhost) 並取名為 ''%%www.example.com%%''

一旦您使用 sFTP 連接上機器, 您需要在 "htdocs/" 內建立一個目錄叫做 "wiki/" , 並將檔案 [[:zh-tw:simple:sftp|上傳]] 傳到 "wiki/" 內
 </note>


 

很多資料將會需要上傳(但少於 10MB), 並且您的上傳軟體需要設定很多檔案(3200)與目錄(500)的權限。

{{ :en:hosting:using-linux:tutorials:simple:dokuwiki:uploading-files.png?nolink }}



==== 設定 DokuWiki ====

安裝 DockWiki 是很以簡單的, 一旦您完成檔案上傳, 用瀏覽器就可以完成安裝. 您應該可以看到如下頁面 (
(如果您是剛剛將虛擬站台設定完成，在這時候，您的轄區設定檔有可能尚未生效):

{{ :en:hosting:using-linux:tutorials:simple:dokuwiki:dokuwiki-new_install.png?w=500&nolink }}

接下來, 用瀏覽器打開安裝頁面 install.php. 例如, 如果您是裝在虛擬伺服器 ''%%www.example.com%%'' 的 wiki/ 底下, 請打開 ''%%http://www.example.com/wiki/install.php%%''。

{{ :en:hosting:using-linux:tutorials:simple:dokuwiki:dokuwiki_installphp.png?w=500&nolink }}

您可以在安裝畫面右上角找到選單來選擇語系。

<note>
您可能會在這裡碰到有一些檔案錯誤的訊息; 這是正常的. 因為安裝程式無法改變伺服器上面的檔案權限。

暫時調整 "conf/" 與 "data/" 的權限為 "700" , 來修正安裝程式錯誤的訊息。

一旦權限調整完畢, 您將可以存取設定頁面
</note>

在此, 請完成管理者的登入資料設定。

一旦您送出表單, 會收到一個確認訊息, 接下來因為安全的因素, 請您刪除 "install.php"。
按下登入按鈕進行登入, 登入後, 按下 "管理(Admin)" 按鈕來自訂化您的新 wiki。

完成了! 如果您想要了解更多設定 DokuWiki 的細節, 請參考 [[http://wiki.splitbrain.org/wiki:installer|DokuWiki 的官方文件]].