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页面支持的格式，保存到剪贴板。使用插件搞定。