今天由于工作需要作Wiki engine evaluation:
看了众多Java 环境的wiki:jspwiki比较简单实用,下载来玩玩。
1.去www.jspwiki.org 下载stable 版本的wiki:
2.解压,把jspwiki.war放到tomcat的webapp下,启动tomcat
3.参数设置
下面的一些设置基本都是集中修改JSPWiki/WEB-INF/jspwiki.properties这个文件的
以下为引用:
文件存放位置:JSPWiki是基于文件系统存放资料的,所以你必须指定一个文件目录。改变jspwiki.fileSystemProvider.pageDir这个属性,在Win32平台上,
路径的分隔符为双反斜线,例如jspwiki.fileSystemProvider.pageDir=C://MyWiki
文件编码格式:如果你需要正确的显示中文,请将#jspwiki.encoding = UTF-8前面的#去掉,即文件的编码格式为UTF-8。
附件存放位置:JSPWiki的页面上提供上传附件功能,与一般的资料相同,它的附件也是存放在某一个文件目录下的如jspwiki.basicAttachmentProvider.storageDir = C://MyWiki/Attachment
Rss支持:需要改动jspwiki.baseURL,把该属性指向你的JSPWiki地址,如
jspwiki.baseURL=http://localhost:8080/JSPWiki/。Rss输出的语言设定,如果需要中文支持,需改变jspwiki.rss.channelLanguage= zh-cn。更新Rss服务的时间为jspwiki.rss.interval = 3600(默认为3600秒,可以改为你想要的数字)版本控制:如果你希望得到文件改动的版本历史。你可以使用JSPWiki本身提供的基于文件的不需要任何RCS支持的VersionFileProvider,请改动jspwiki.pageProvider = VersioningFileProvider。如果希望得到基于RCS的版本支持,需要更多的步骤,本文不会提及,请移步http://www.jspwiki.org/Wiki.jsp?page=WindowsInstall
JSPWiki的配置在jspwiki.properties里面,下面介绍几个常用的:
- jspwiki.pageProvider = FileSystemProvider ——页面存储方式。推荐使用VersioningFileProvider,提供简单的版本控制功能
- jspwiki.usePageCache = true ——页面缓存,缺省值就是了
- jspwiki.fileSystemProvider.pageDir = /p/web/www-data/jspwiki/ ——wiki内容存储的位置,也就是那一堆txt文件所在的位置
- jspwiki.encoding = UTF-8 ——如果你想使用中文的话,那么这个配置项前面的注释必须去掉
- jspwiki.translatorReader.allowHTML = false ——是否允许wiki里面支持html,强烈推荐不要允许,因为wiki是协同编辑的,如果有人恶意使用js的话,就惨了,呵呵。
- jspwiki.templateDir = default ——wiki的模板。可以到jspwiki上下载模板,放到templates目录下,然后在这里改一下名字就可以了
- jspwiki.translatorReader.inlinePattern.1 = *.jpg ——如果想让wiki支持更多的图片格式,在这儿改就是了
- jspwiki.lucene.analyzer = org.apache.lucene.analysis.cjk.CJKAnalyzer --支持中文搜索
4.选择一个模板
JSPWiki支持使用第三方模板替换掉发布包自带的"defalut"模板;比较流行的有MGR和NexB;(我采用了NexB,这个更酷一些)
jspwiki.applicationName = JSPWiki ——这里可以改为自己的wiki名字