JSPWiki的配置过程和简单应用

1. 安装tomcat，版本4以及以上，注意安装时最好选择没有空格的文件夹下，放在根目录下最好。如：d:/tomcat55/。主要是因为wiki的一些插件对此有要求。

2. 下载JSPWiki
下载地址：http://www.jspwiki.org/wiki/JSPWikiDownload
下载文件：jspwiki-2.2.33-bin.zip

3.拷贝压缩包里的JSPWiki.war到tomcat的webapps下，重命名为你的wiki的名字，比如：tomwiki.war

4.启动tomcat，浏览器下输入： http://127.0.0.1:8080/tomwiki/ tomcat将开始部署你的wiki，自动在webapps下创建tomwiki文件夹，包括jsp文件和配置信息，其中WEB-INF下包含的jspwiki.properties记录最主要的配置信息，可在http://127.0.0.1:8080/tomwiki/Install.jsp中进行修改。
同时tomcat将自动为你的wiki创建数据文件夹，在linux下是/p/web/www-data/jspwiki，在windows下是D:/p/web/www-data/tomwiki（假设tomcat装在D盘）

5.输入http://127.0.0.1:8080/tomwiki/Install.jsp 配置你的wiki,配置成功后将修改jspwiki.properties文件的相关项。
(1).Application Name: tomwiki
(2).Base URL: http://127.0.0.1:8080/tomwiki/ (3).File storage: /p/web/www-data/tomwiki/
(4).Work directory: /tmp/
(5).Log files: /tmp/tomwiki.log

6.解压缩jspwiki-2.2.33-bin.zip下的JSPWiki-samplepages.zip到你的数据目录下D:/p/web/www-data/tomwiki。重启tomcat后将创建出一个简单规模的wiki。注意如果使用中文模板的话就不要做这个了，参见条款8（使用模板）

7.更多的配置，直接修改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 －－支持中文搜索

8.使用模板
JSPWiki支持使用第三方模板替换掉发布包自带的"defalut"模板；比较流行的有MGR和NexB；
使用中文模板库：star_zh_CN. 下载JSPWiki_zh_CN.zip，解压缩
a. 将templates/star_zh_CN目录复制到{tomwiki}/templates里.
b. .将wikipages目录下的txt文件复制到tomwiki的"wiki网页目录"里.
"wiki网页目录"请参照{tomwiki}/WEB-INF/jspwiki.properties文件里的jspwiki.fileSystemProvider.pageDir值.
c. 修改{tomwiki}/WEB-INF/jspwiki.properties文件里的jspwiki.templateDir属性的值为star_zh_CN.
d.(重新)启动web服务器.

9．使用word来编辑支持jspwiki的页面，使用word宏jspwikiVBA,下载jspwikiVBA.zip,解压缩得到AWord2JspWiki.bas.
使用时只需要在word界面中输入alt+F11打开内置的Visual Basic 编辑器，然后Ctrl＋M导入"AWord2JspWiki.bas "即可，保存后退出，之后就可以用这个宏进行转换了。比如现在就打开一个待转换的word文档，选择alt+F8，弹出对话框，选"AWordToJsp"
后点"运行"后宏开始执行转换任务，完成后剪贴板中已经保存了转换成jspWiki格式的文本内容了，此时只要在jspWiki编辑框中直接粘贴即可。保存后即可在wiki中显示转换后的效果,转换后可能有些地方仍然需要修改，不过工作量要小很多了

10．JSPWiki的简单应用：
a.添加页面：单击一个还未编辑的链接，将进入编辑界面，编辑后保存就行了。注意没有编辑过的页面链接文字下有虚线。
b.删除页面：单击右下角的"more info"或是"更多信息",进入页面的版本历史信息，点击"删除页面"则删除页面，注意有很多情况下是删除是锁定的。
c.编辑页面：在编辑界面下进行，一般的文字编辑跟记事本一样操作，常见的问题有：
＃标题：按字体规模前面加感叹号：比如"!!!www.tom.com".显示最大的字体
＃链接：内部链接则直接在[]中写上wiki页面名，比如"[关于|About]"
外部链接则一定要加"http://",比如"[tom在线|www.tom.com]"
＃图片：[http://61.135.158.241/ad/player.gif]或者单击"Attach file"或是"添加附件"，上传一个图片
＃word宏：在word下输入文字再变成jspwiki页面支持的格式，保存到剪贴板。使用插件搞定。