JSPwiki的安装手记

 今天由于工作需要作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名字