使用JSPWiki建立自己的Wiki服务

aaronngup

建立自己的JSPWiki应用——本文讲述如何使用JSPWiki建立一个自己的wiki应用 内容提要JSPWiki是一个基于文本文件的简易wiki系统包括了身份认证和版本控制功能。完全采用JSP/Sevelet开发，采用UTF-8，能很好的支持中文，可以直接使用中文名作为页面（page）名。是一个简单易用的Wiki引擎。本文将向您展示如何建立一个自己的
JSPWiki
应用。包括改变模板，安装插件以及为你的wiki加入身份认证功能。 您可以到
http://www.jspwiki.org
下载程序包和其它插件。目录       
[1]
在Tomcat下建立JSPWiki应用        
[2]
更换模板        
[3]
安装插件        
[4]
使用身份认证功能 在Tomcat下建立JSPWiki应用 [#1]1.      下载JSPWiki（我使用的是2.2.28），解压缩，把jspwiki.war直接Copy到Tomcat下面webapps目录下 2.      启动tomcat，JSPWiki.war会自动解压缩到webapps目录下 3.      到JSPWiki/webinf目录下面修改jspwiki.properties文件，作如下修改   jspwiki.fileSystemProvider.pageDir = C:\\temp\\jspwiki
jspwiki.basicAttachmentProvider.storageDir = C:\\temp\\jspwiki
log4j.appender.FileLog.File = C:\\temp\\jspwiki.log 4.      可以运行http://127.0.0.1:8080/JSPWiki/Install.jsp帮助完成上述配置 ,为了能够在wiki中使用HTML需要修改 jspwiki.properties，把allowHTML 选项打开   jspwiki.translatorReader.allowHTML = true 更换模板 [#2]1.      下载模板redman，并且解包到tomcat_home\webapps\JSPWiki目录下的template的目录下，目录名称应该就是redman 2.      修改jspwiki.propertiest文件,把   jspwiki.templateDir = default 改成    jspwiki.templateDir = redman 安装插件 [#3]安装java2html插件 1.      下载java2html插件 2.      把下载下来的java2html.jar拷贝到 tomcat_home\webapps\JSPWiki\WEB-INF\lib目录下 3.      修改 jspwiki.propertiest文件 jspwiki.plugin.searchPath = de.java2html.plugin.jspwiki 安装PDF插件1.      首先需要下载其它组件。下载
Apache FOP
并解包把avalon-framework.jar (或者其他版本，比如:avalon-framework-cvs-20020806.jar)、batik.jar、fop.jar拷贝到WEB-INF/lib下；下载
jTidy
并解包,拷贝Tidy.jar to WEB-INF/lib目录下；下载
JIMI
并解包,把JimiProClasses.zip拷贝到WEB-INF/lib/目录并改名为JimiProClasses.jar. 2.      在
jspwiki
下载pdf插件 3.      把下载下来的wikipdf.jar拷贝到 tomcat_home\webapps\JSPWiki\WEB-INF\lib目录下 4.      修改 tomcat_home\webapps\JSPWiki目录下Web.xml文件，增加下面的内容  
    Wiki2PDFServlet
    class>se.eminds.jspwiki.Wiki2PDFServletclass>
    Wiki2PDFServlet
    /wiki.pdf
5.      修改templates/default/ViewTemplate.jsp文件，加入下面的内容  
&ext=.pdf">View PDF
  注意： 修改jspwiki.propertiest文件时，"="后面的变量值后面不能有多余的空格或者tab，否则JSPWiki无法正常读取配置文件导致改动没有效果。使用身份认证功能 [#4]1.      修改jspwiki.properties文件，加入下面的内容： jspwiki.authenticator = FileAuthenticator
jspwiki.fileAuthenticator.fileName = /tmp/passwords.txt
jspwiki.auth.useOldAuth=true
# Add the following line authorize all users
jspwiki.policy.strictLogins = true 2.      编辑对应的password.txt文件加入合法用户，例如：
# The format is simply username = password
# No encryption is used currently.
# Comments are allowed; prepend with hash.
ebu = foobar
ubi = frobozz 3.      设置全部页面的默认访问权限，增加一个DefaultPermissions页面，包含下面的内容
[{SET defaultpermissions='ALLOW view Guest;DENY edit Guest;ALLOW edit KnownPerson'}] 4.      管理员用户组。可以在jspwiki.propertiest文件中指定管理员用户组的名称，如： jspwiki.auth.administrator = WikiAdmin5.      那么默认的管理员用户组被命名为WikiAdmin，然后可以创建WikiAdmin页面加入成员，下面指令可以在WikiAdmin中加入JackJones，JillJones两个用户
[{SET members='JackJones, JillJones'}] 6.      如果需要设置单独页面的访问权限，可在页面内容前面加上访问规则，例如：
[{ALLOW view Guest}] [{DENY edit Guest}] [{ALLOW edit ebu, ubi}] 7.      如果需要增加一个用户组Xyz，增加一个Xyz的页面，加入下面的指令
[{SET members='Foo, Bar'}] }] 注意： JSPWiki有几个默认的用户组。    任何一个访问wiki的用户都属于Guest用户组；    任何一个使用user prefenrences设置了用户名的用户都属于NamedGuest用户组；    所有通过了身份认证的用户属于KnownPerson用户组。注意： 目前的身份认证处理方式是临时的。    目前的身份认证方式是临时的，到2.4以上的版本会改变。目前权限规则实现有问题， 必须使用管理员用户组。因为加上了禁止guest访问的权限管理规则后，除了管理员外所有用户都无法编辑wiki。 如果希望一个用户有wiki的编辑权限，别忘了把他加到管理员用户组。
摘自：观海临朝
               
               
               

本文来自ChinaUnix博客，如果查看原文请点：http://blog.chinaunix.net/u2/60606/showart_696143.html