Monthly Archives: March 2007

身為一個只熟pico這個shell editor的人，我真的是麻瓜的可以。很久以前曾經試著在託管的主機上嘗試著裝kwiki，一堆設定搞的我暈頭轉向，最後雖然也是裝了起來，但是仍是棄kwiki而就oddmuse。
半夜一直咳的睡不著，所以看到kwiki終於有了2.0，也忍不住手養來試試。想不到一下就裝好了。(果然有2.0有差 XD) 如果你也是麻瓜的話，可以試試以下的步驟。
準備材料：Linux/FreeBSD的主機, shell access
如果你對shell或是perl很熟，基本上官網上的安裝程序，你看到這裡就可以轉台了。
首先我先把官方網站的安裝程序貼在這裡

svn checkout http://svn.kwiki.org/kwiki/trunk /usr/local/kwiki
export PATH=/usr/local/kwiki/bin:$PATH
kwiki -new /path/to/cgi/mykwiki

第一行，是要你用svn把最新的code下載下來。如果你不知道怎麼用的話，也可以直接下載最新的tar
第二行，在你的shell設定kwiki的路徑
第三行，生出一個全新的kwiki

我的主機是放在DreamHost。所以下面的範例會以DreamHost shell為準。

步驟一，除了上述svn以外，你可以把最新的kwiki-trunk-YYYYMMDD.tar.gz
丟到主機上，然後在shell裡面輸入
tar xzf kwiki-trunk-YYYYMMDD.tar.gz
將檔案解壓縮。

步驟二，在shell下面設定路徑。
export PATH=/path/to/kwiki/bin:$PATH
這裡，我剛剛將解壓縮過的kwiki-trunk-YYYYMMDD的檔案夾改成了kwiki/。請將這裡的/path/to/kwiki改成你放kwiki/的路徑，我將我的放在/home/acer下面。

步驟三，你只要在shell下面打入
kwiki -new /path/to/cgi/mykwiki
這裡/path/to/cgi/mykwiki是你要在主機上裝kwiki的路徑，而我現在用的是dreamhost，我想要把我的wiki放在idplay.net/wiki下面，所以我輸入的是，
kwiki -new ~/idplay.net/wiki
這樣就裝好了。

裝好以後，第一件要作的事情當然就是換新衣。看不懂安裝手冊，只好請問whiteg。kwiki的default theme是Basic，那要怎麼換新衣呢？
到你剛剛裝好的目錄下面 (我的例子是 idplay.net/wiki) 下面有個檔案叫做plugins，裡面放的就是你的kwiki會用到的plugin。
我現在要把原本的Basic Theme，改成ColumnLayout。用你熟悉的編輯器將plugins打開，在
Kwiki::Theme::Basic
前面加上# ，然後把
# Kwiki::Theme:: ColumnLayout
前面的 # 拿掉
原則上，開頭沒有#的，就是目前你正在使用的plugins。請用這個邏輯去安裝其他的plugins。Kwiki的theme其實就在plugin裡面。官網上有screenshot作為參考。
改完的最後，請記得在shell下面輸入
kwiki -update
這樣就好了。
另外你也可以在shell下面輸入
kwiki -help
會有kwiki的指令列表

kwiki -new [path] [...]