DokuWiki安裝程序

1 下載安裝檔

先切換到安裝目錄
下載 dokuwiki 最新版本¹⁾檔案
解開壓縮檔
將目錄名稱更改為自己所希望的目錄名稱
將檔案目錄權限更改為 apache²⁾

cd /var/www/html/
wget http://www.splitbrain.org/_media/projects/dokuwiki/dokuwiki-2008-05-05.tgz
tar -zxvf dokuwiki-*.tgz
mv dokuwiki-2008-05-05 dokuwiki
chown -R apache:apache dokuwiki

2 安裝參數設定

在 2006-11-06 版之後, 就提供網頁安裝參數設定功能
所以在安裝路徑網址下 install.php (Exp. http://192.168.11.236/dokuwiki/install.php)
右上角將語系改成 zh-tw
左邊欄位就開始一一輸入
1. Wiki Name : MyWiki
2. 依據將所有的欄位填好
3. 我是設定預設的 ACL 是屬於 Closed Wiki
4. 點下[儲存]
將 install.php 刪除掉 .. 實際命令語法
```
cd /var/www/html/dokuwiki
rm install.php
```

2.1 第一次登入

輸入新的 wiki 網址後, 因為剛剛設定為 Closed Wiki 所以會出現 拒絕尚未授權 的訊息
點[登入]輸入剛剛設定的管理者帳號密碼登入
點[管理選單]→[Configuration Settings]
1. [Use first heading for pagenames] ← 打勾, 讓每頁的 Header 當頁面名稱
2. [Send info on newly registered users to this email address] ← tryweb@ichiayi.com 有新註冊就通知到這個 E-Mail
3. [Allow embedded HTML] ← 打勾, 允許使用 html 語法
4. [Send change notifications to this email address] ← tryweb@ichiayi.com 有改到網頁就通知到這個 E-Mail
5. [Enable page subscription support] ← 打勾, 允許使用者訂閱網頁
6. [Use nice URLs] ← .htaccess ³⁾
7. [Email address to use for automatic mails] ← tryweb@ichiayi.com 表示寄信者的 E-Mail
8. [Generate Google sitemap (days)] ← 1 表示每天都更新 Google Sitemap
9. [XML feed type] ← RSS 2.0
點[儲存]
登入主機, 確認 apache 設定檔 AllowOverride 設定為 All
修改 .htaccess 設定檔

實際處理語法

su - root
vi /etc/httpd/conf/httpd.conf

:
#
# AllowOverride controls what directives may be placed in .htaccess files.
# It can be "All", "None", or any combination of the keywords:
#   Options FileInfo AuthConfig Limit
#
    AllowOverride All

#
# Controls who can get stuff from this server.
#
:

vi /var/www/html/dokuwiki/.htaccess

.htaccess

<Files ~ "^[\._]ht">
    Order allow,deny
    Deny from all
    Satisfy All
</Files>
 
RewriteEngine on
 
RewriteRule ^_media/(.*)              lib/exe/fetch.php?media=$1  [QSA,L]
RewriteRule ^_detail/(.*)             lib/exe/detail.php?media=$1  [QSA,L]
RewriteRule ^_export/([^/]+)/(.*)     doku.php?do=export_$1&id=$2  [QSA,L]
RewriteRule ^$                        doku.php  [L]
RewriteCond %{REQUEST_FILENAME}       !-f
RewriteCond %{REQUEST_FILENAME}       !-d
RewriteRule (.*)                      doku.php?id=$1  [QSA,L]
RewriteRule ^index.php$               doku.php
 
# 如果需要強制轉 SSL 就將以下兩行前面的 # 去掉
#RewriteCond   %{SERVER_PORT}  !^443$
#RewriteRule   ^(.*)?$   https://%{SERVER_NAME}/dokuwiki/$1 [L,R]

3 原有資料帳號連結

如果有需要將原本的資料頁面移轉過來, 只需要將 data 的內容搬移到新的路徑內即可.

實際命令語法

cd /var/www/html/dokuwiki
mv data data.org
cp -a /var/www/html/dokuwiki.old/data .

在 2006 年版本中, data 內並無 index 目錄, 所以要自己先加入一個空的 index 目錄, 然後設定可以讓 apache 讀寫的權限

在 2007 年版本中, data 內並無 tmp 目錄, 所以要自己先加入一個空的 tmp 目錄, 然後設定可以讓 apache 讀寫的權限實際處理語法

cd /var/www/html
wget http://www.splitbrain.org/_media/projects/dokuwiki/dokuwiki-2008-05-05.tgz
tar -zxvf dokuwiki-2008-05-05.tgz
原本安裝的 wiki 在 /var/www/html/wiki 目錄內
mv wiki wiki.old
mv dokuwiki-2008-05-05 wiki
chown -R apache:apache wiki
cd wiki
rm install.php
cp -a ../wiki.old/.htaccess .
mv data data.org
cp -a ../wiki.old/data .
cd data
mkdir tmp
chown -R apache:apache tmp/
rm -rf cache/*
cd ../lib
mv tpl tpl.org
cp -a ../../wiki.old/lib/tpl .
cp -a tpl.org/* tpl/
mv plugins plugins.org
cp -a ../../wiki.old/lib/plugins .
cp -a plugins.org/* plugins/
cd ../conf
cp -a ../../wiki.old/conf/users.auth.php .
cp -a ../../wiki.old/conf/acl.auth.php .
cp -a ../../wiki.old/conf/local.php .
再複製有更改過的設定檔
cp -a ../../wiki.old/conf/mime.conf .
cp -a ../../wiki.old/conf/interwiki.conf .
開啟 wiki 頁面確認沒問題就可移除掉剛剛所 mv 的 *.org
cd /var/www/html/wiki
rm -rf data.org
rm -rf lib/plugins.org
rm -rf lib/tpl.org

4 安裝 Plugin

參考 DokuWiki Plugin 精選

5 下載其他 Template

參考 wiki:tpl:templates
推薦 Simple Template

實際安裝 simple template 程序語法

cd /var/www/html/wiki/lib/tpl
wget http://www.chimeric.de/_media/projects/dokuwiki/template/simple/download/template-simple-2007-05-24.tgz
tar zxvf template-simple-2007-05-24.tgz

如果需要, 可以到 lib/tpl/simple 內修改 main.php 與 style.ini 內容

6 延伸參考資料

DokuWiki Plugin 精選	2007-11-01 11:44	蔡宗融
DokuWiki安裝程序	2010-01-25 17:00
Dokuwiki	2008-09-15 06:38	蔡宗融
Dokuwiki 使用技巧整理	2008-03-27 10:44	蔡宗融
Dokuwiki 升級方式	2008-07-30 18:17	蔡宗融
Dokuwiki 相簿應用的 plugin	2008-07-03 06:22	蔡宗融
Dokuwiki 自動切換 Mobile 呈現頁面方式	2011-09-13 18:57	蔡宗融
Mantis 與 Dokuwiki 整合作法	2008-02-26 15:57	蔡宗融