刚才无意中发现自己很久以前写给同事看的东西,干脆贴出来。
- 安装环境
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 的较高级的应用。