JSPWiki配置

大家都知道博客吧，而wiki(百科)，是与博客有相似的功能，但不同的宗旨，再在wiki的需求也在不断的升温，基于java，今天就讲讲有名的JSPWiki的配置吧。

 

一： 声明：tomcat6.0 + JDK1.6 + JSPWiki2.8

 

二： 下载JSPWiki2.8 ，JWPWiki官方也是用它做的，可以看一下效果，还挺好的

 

三： 假如下载下来的是JSPWiki-2.8.3-bin.zip，解压后得到JSPWiki文件夹，找到JSPWiki.war和JSPWiki-corepages_zh_CN.zip ，到你的工程WebRoot下，什么也不用配置

注：JSPWiki-corepages_zh_CN.zip是已经准备好的一些wiki知识和JSPWiki的介绍，这样，一但你启动JSPWiki，就会看到一些东西，否则除了logo外，就没有什么内容了。

 

四： 将你的工程直接做为http://localhost运行，点install，只填baseURL那一项 ，其它的都默认就可以了，再点配置，会提示给你一个admin的密码 ，是随机生成的，记下来吧，有用的。然后会提示你重启tomcat，我们不要重启，直接关闭tomcat

 

五： 进入你的工程/WebRoot/WEB-INF/jspwiki.properties ，我们重点改几项，代码如下：

#这就是title的内容，随便命名都可以，中文要以utf-8字符存储，如/u767E/u79D1是百科的utf-8编码

jspwiki.applicationName =MyJSPWiki--wiki

#baseURL中的myjspwiki也就是在%CATALINA_HOME%conf/server.xml中，host->context->path的值，但记住，一定不要忘记最后一个"/"，否则，自己试试看吧

jspwiki.baseURL = http://localhost/myjspwiki/

#这里的pageDir也就是host->context->docBase的值，相信你明白什么意思

jspwiki.fileSystemProvider.pageDir = E://workspace//jspwiki//WebRoot

#文件数据库的位置，由于JSPWiki采用文件系统存储内容，没有涉及到数据库，这也就是这项配置的原因了

jspwiki.basicAttachmentProvider.storageDir = E://workspace//jspwiki//WebRoot//database

#编码配置，原是en-us

jspwiki.rss.channelLanguage = zh-cn

#日志配置

log4j.appender.FileLog.File = E://workspace//jspwiki//WebRoot//log//jspwiki.log

#另外你也可以更改lucene的中文分词，不过你要自己加入相应的xx.jar包

jspwiki.lucene.analyzer = com.chelb.mmseg4j.analysis.ComplesAnalyzer

#允许上传的附件类型

jspwiki.attachment.allow = .jpg .gif .zip .png

 

六： 如何修改左边栏

方法一：找到-->你的工程/lestMenu.txt文件，你就可以编辑了

方法二：输入-->http://localhsot/jspwiki/Edit.jsp?page=LeftMenu也可以编辑

 

七： 关于权限

 

JSPWiki的权限分为如下：

组权限，主要指的是对分组进行浏览，编辑，删除等相关操作的权限
Wiki权限，则规定了是否允许创建组，创建页面，创建临时帐号，注册新用户，登陆。
页面权限，规定了对哪些页面有相应的浏览，编辑，评论，删除，上传附件和修改的权限。

 

内置的用户组/角色有如下：
ALL，指的是所有用户。
Anonymous，指的是匿名用户，既不登陆，也不提供带用户信息的cookie。
Asserted，指的是带用户信息的cookie。
Authenticated，指的是经用户数据库验证的用户。
Admin，是管理员组。
由此可见，如果支持cookie的话，那么Authenticated用户组是Asserted用户组的子集。Asserted用户组包含了临时帐号和正式帐号，Authenticated。

 

页面级别的权限控制如下：
页面级别的权限控制要比全局控制的优先级高用户组仅包含了正式帐号。此外，我们也可以看出，用户自定义组是Authenticated组的一个子集，给一个例子，

[{ALLOW edit GroupAdmin}]
[{ALLOW view All}]

 

//PagePermission 页面权限
//delete and rename imply modidy
//modify implies edit and upload
//edit implies comment and view
//comment and upload imply view
//可以使用的权限包括: *, comment, delete, edit, modify, rename, upload, view.

//WikiPermission Wiki 权限

//createGroups implies createPages
//禁用了editProfile后，不能注册，不能更改密码和附加信息

//可以使用的权限包括: *, createGroups, createPages, editPreferences(首选项), editProfile(个人信息和注册) and login.

//GroupPermission 组权限
//edit implies view
//delete implies edit and view
//GroupPermission accepts a special target called <groupmember> that means "all groups that a user is a member of."
//or means "allow Authenticated users to edit any groups they are members of."
//可以使用的权限包括: *, view, edit, delete.

 

八： 修改Logo

WebRoot/templates/dafault/jspwiki.css，这是默认css，搜索.applicationlogo a和.applicationlogo a:hover来修改Logo吧

而Logo在WebRoot/images/jspwiki_logo.png，

最后： 再重新配置一下你的%CATALINA_HOME%conf/server.xml文件，重启吧，Enjoy!!

 

九：使用模板

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服务器.

 

 

使用身份认证功能 [#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的编辑权限，别忘了把他加到管理员用户组。