JSPWIKI下载及安装

下载地址:

http://www.apache.org/dist/jspwiki/2.10.1/binaries/

目录

[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 = WikiAdmin

5. 那么默认的管理员用户组被命名为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的编辑权限，别忘了把他加到管理员用户组。