剛才無意中發現自己很久以前寫給同事看的東西,干脆貼出來。
- 安裝環境
Wiki的功能比較簡單,因此互聯網上Wiki的實現非常非常的多,有各種各樣的實現,基于asp、java、php、Python、perl等等,大家可以根據情況自己挑一個。從這方面看,Wiki映證了一個道理,簡單的就是最美的,好像有一大筐做工精致的藝術品擺在你面前讓你挑,真是人生快事。至于俺么,當然是選擇基于Java的了!有人做好了給你用,爽哦。
我的安裝環境:Linux + Tomcat-5.0.19 + JSPWiki 2.0.52 + jdk1.4 。
- 開始安裝的準備工作
下載 JDK, Tomcat 并安裝,這里就不說了,呵呵。
從 http://www.jspwiki.org/ 下載JSPWiki, 當前的穩定版本是2.0.52。當然這個網站本身也是用Wiki做的,去下載時你就已經認識到Wiki是什么東東了。下載下來的是一個壓縮文件 jspwiki-2.0.52-bin.zip ,解壓后進入解壓的文件夾,可以看到JSPWiki.war、JSPWiki-samplepages.zip兩個文件,前者就是JSPWiki的程序了,JSPWiki-samplepages.zip里是其官方給出的一些例子頁面,很有價值哦。
- 安裝
將JSPWiki.war解壓到一個文件夾,假設叫wiki,后放到 Tomcat 的Webapps文件夾下,進入 wiki/WEB-INF/ , 編輯 jspwiki.properties ,進行相關的設置,幾個重要的參數:
a) jspwiki.applicationName = your app name -------- 你這個Wiki網站的名稱
b) jspwiki.pageProvider = VersioningFileProvider -------- Wiki對頁面的管理方式,有三種: RCSFileProvider, FileSystemProvider, VersioningFileProvider(推薦使用).
c) jspwiki.fileSystemProvider.pageDir = /home/wiki -------- 網站內容存放地點
d) jspwiki.basicAttachmentProvider.storageDir = /home/wiki/attach -------- 網站用戶上傳的附件的存放地點
e) jspwiki.encoding = UTF-8 -------- 設置頁面的編碼格式
f) jspwiki.rss.channelLanguage = zh-cn -------- 設置rss語言格式,如果你不需要rss功能的話可以不設置
g) jspwiki.baseURL= ——wiki的基本URL,如果你不需要rss功能的話可以不設置
h)jspwiki.translatorReader.allowHTML = false -------- 是否允許wiki里面支持html,網站對外開放時最好不要設,因為wiki是協同編輯的,如果有人惡意使用js的話,就慘了,呵呵。
- 設置字符集
安裝后要使有中文問題,注意看上一項4中的 e ,f 兩項是不是都設置對了.
- 運行Wiki,添加頁面
jspWiki內置了一些用于布局的版面page,包括Home、Index、LeftFooter、LeftMenu、LegalAndPrivacyNotice、MenuBar、RightFooter、RightMenuBar、Website、Contacts、ErrorMessage等等,只要稍加編輯就可以攢一個挺專業的網站。激活它們的方法是瀏覽器中輸入: http://localhost:8080/wiki/Wiki.jsp?page=pageName.
- 后期處理
設置tomcat為自啟動: 在startup.sh 中設置 JAVA_HOME , CLASSPATH , PATH 等環境變量,在 /etc/rc.d/rc.local 中添加啟動腳本。
熟悉wiki之后可以進一步學習FitNesse之類的 Wiki 的較高級的應用。