JSPWiki安装指南

wtuyss

JSPWiki安装指南
   关于wiki我想不必多说，既然你决定要装一个wiki软件，本身对wiki的了解应该不成问题，如果你有兴趣对wiki有进一步的了解，请移步维基百科.
　　需求
   在正式进入安装步骤之前，我需要提醒一下以下的安装都是基于一些如下的环境的

以下为引用：    操作系统：MicroSoft的Win32系统，包括win95，win98，win2000及win xp(本人的操作系统).    Java Runtime Enviroment(JRE):需要1.3以上版本，本文中版本的1.4.2_02。   Servlet 2.2兼容网页服务器：当然也可以运行于2.3或2.4兼容服务器。本文中安装测试在Tomcat 4.1.30 或jetty 4.2.20。   一台机器作为服务器，普通的pc机即可。本文中pc配置为Pentium m 1.4,256M ,当然JSPWiki的官方站点运行在一台PII 266,192M的机器。   一些耐心（这是官方站点上说的），但是我倒是觉得安装是极其简单的，当然你需要有一些部署web应用的经验。   可选项（如果你对这一段的名词有些陌生，可以考虑跳过这一段）：    如果你需要你的wiki站点有基于RCS的版本历史功能，不幸的是windows操作系统并没有提供这个功能。不过你可以使用JSPWiki自带的基于文件的版本管理。    如果你需要使用Log4j的Mail功能，你需要JavaMail和Java Activation Framework libraries。

安装
   首先你必须从JSPWiki的官方站点下载JSPWiki安装的压缩包,本文中提到的版本为2.0.52。先将jspwiki-version-bin.zip的压缩包解压，得到其中的JSPWIKI.war的包，下面我们的工作就基于这个包。在安装之前你也可以看README文件了解一些基本的信息。
   怎样处理WAR文件:可以将WAR文件解压，得到一个名为JSPWiki的文件夹。我们可以把WAR文件或是该文件夹部署（复制）到$TOMCAT_HOME/webapps或者$JETTY_HOME/webapps目录下，其中的TOMCAT_HOME为你安装的TOMCAT的目录，如C:/Program files/Apache/Tomcat 4.1。不过我推荐你直接使用文件夹部署，因为我们下面的一些设置都是对该文件夹下的一些文件直接修改，如果要对WAR文件部署，那多次压缩解压也是一件麻烦的事。
   下面的一些设置基本都是集中修改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

展示成果
   完成上述的步骤以后，你可以启动你的Tomcat或是Jetty，打开你的浏览器，输入

以下内容为程序代码: http://localhost:8080/JSPWiki

,如果你改动了文件夹的名称，就把JSPWiki改成你的文件夹名称。或者你改变了Tomcat或Jetty的8080端口，也请改成你设置的端口。
   如果你需要汉化JSPWiki，请改动JSPWiki/templates/default下的一些Jsp页面，不过要保证你熟悉JSP文件的编写。作者提供自己汉化过的一个JSPWiki的版本，如果对本文作者的翻译不是很满意的话，你也可以自己做修改。
   如果你需要对现有的JSPWiki增加功能，可以使用它的一些插件如（blog插件，forum插件，todolist插件），可以到JSPWiki官方站点插件下载。
   本文只是提供一些最基本的安装事项，如果希望得到更多的了解，请至JSPWiki的官方站点，该站点也是用JSPWiki架设的