kwiki 2.0 for muggles 麻瓜指南

身為一個只熟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

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

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

  1. 步驟一,除了上述svn以外,你可以把最新的kwiki-trunk-YYYYMMDD.tar.gz
    丟到主機上,然後在shell裡面輸入
    tar xzf kwiki-trunk-YYYYMMDD.tar.gz
    將檔案解壓縮。
  2. 步驟二,在shell下面設定路徑。
    export PATH=/path/to/kwiki/bin:$PATH
    這裡,我剛剛將解壓縮過的kwiki-trunk-YYYYMMDD的檔案夾改成了kwiki/。請將這裡的/path/to/kwiki改成你放kwiki/的路徑,我將我的放在/home/acer下面。
  3. 步驟三,你只要在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] # Generate a new Kwiki
kwiki -update [path] # Update an existing Kwiki
kwiki -add Kwiki::Foo # Add a plugin
kwiki -remove Kwiki::Foo # Remove a plugin
kwiki -install Kwiki::Foo # Download and install a plugin
kwiki -new_view [subdir] # Create a new view under an existing Kwiki
kwiki -update_all # Update all Kwiki dirs under current dir
kwiki -configure # Sitewide Kwiki initial configuration

你會發現,其實也可以直接用 kwiki -remove來換theme。

This entry was posted in tool. Bookmark the permalink. Post a comment or leave a trackback: Trackback URL.

Post a Comment

Your email is never published nor shared. Required fields are marked *

*
*