Jetspeed JetExpress Tutorial Portal 笔记2 -- 定制...

来源:百度文库 编辑:神马文学网 时间:2024/04/28 03:20:19
Jetspeed JetExpress Tutorial Portal 笔记2 -- 定制外观
Category:Jetspeed, Author: admin, Popularity: 4% [?] Jetspeed JetExpress Tutorial Portal 笔记2
--定制外观
本文主要介绍如何在自定义portal项目中对界面外观进行调整。也是jetspeed二次开发中比较重要的部分。
对Portal外观的定制包括:
Portal皮肤   Portal Skins(or Decorators) Portal主题   Portal Themes
其中装饰器(Decorators)用来修改Jetspeed Portal的外观,而主题(Themes)用来修改Jetspeed Desktop的外观。
Jetspeed Desktop是另外一种表现形式,内容和portal中的是相同的。
页面装饰器(Page Decorators)
每个Jetspeed页面(Jetspeed page)可以关联一个页面装饰器(page decoration)。
页面装饰器(page decoration)控制了一个portal页面的某些重要方面,包括:
颜色(color),图像(images),样式表(css)
页眉(header)的位置
页面的边缘空白(margin)
页脚(footer)的位置
页面菜单(menu)的显示
窗口中Action按钮的显示
页面中的portlets如何放置由页面布局(layouts)处理,而不是装饰器(Decorators)控制。
Jetspeed有很多种装饰器(decoration),大部分页面的默认页面装饰是由叫做 tigris 的装饰器完成的。
Portlet装饰器(Portlet Decorators)
页面中的每个Jetspeed portlet窗口可以关联一个不同的portlet装饰器。portlet装饰器控制着一个portlet窗口的某些重要方面:
portlet窗口的颜色、图像、样式表
portlet标题的位置
portlet窗口的边框
窗口中Action按钮的显示
与页面装饰器类似,Jetspeed默认提供了很多portlet装饰器,默认的portlet装饰器是tigris。
桌面主题(Desktop Themes)
Jetspeed桌面有独立的装饰器,叫做桌面主题(Desktop Themes),和页面装饰器及其类似。
Jetspeed桌面中,负责布局控制的是Jetspeed桌面引擎(Desktop Engine)。
Jetspeed默认提供的桌面主题很少,默认的叫做blue。
桌面主题用不同的内容组装页面上的DIV,内容包括portlets和菜单等。
菜单是从一系列资源中获取的,这些资源被叫做Portal Site。Portal Site是由portal资源构成的一个内容树。Portal Site可以被保存到文件系统或数据库中。资源可以是一个页面,一个文件夹或者一个连接。菜单可以自定义。
自定义装饰器及桌面主题:
/JetspeedTraining/workspace/jetexpress/portal/src/webapp这个目录是定制portal项目中用于覆盖默认内容的目录,编译过程中,该目录
如果有内容,则覆盖默认内容,默认的文件应该是在jar文件中保存的。
自定义的页面装饰器放在
/JetspeedTraining/workspace/jetexpress/portal/src/webapp/decorations/layout/express-page目录下 自定义的portlet装饰器放在
/JetspeedTraining/workspace/jetexpress/portal/src/webapp/decorations/portlet/express-portlet目录下 自定义的桌面主题(Desktop Themes)放在
/JetspeedTraining/workspace/jetexpress/portal/src/webapp/desktop-themes/express目录下 自定义默认页面文件放在
/JetspeedTraining/workspace/jetexpress/portal/src/webapp/WEB-INF/pages/default-page.psml
下面是默认页面中,关联默认布局装饰器、portlet装饰器、桌面主题的代码
portlet-decorator=”express-portlet”
skin=”express”/>
其中
layout-decorator属性定义布局装饰器
portlet-decorator属性定义portlet装饰器
skin属性定义桌面主题
为了让新的自定义资源(装饰器、主题和页面)生效,可以用mvn -P tomcat,min再次编译并重新部署。
如果portal正在运行,那么可以用Jetspeed提供的一个ant脚本来拷贝修改的portal资源。
脚本放在/JetspeedTraining/workspace/jetexpress/build.xml(由resources目录拷贝)
只要执行ant就可以把修改的资源拷贝到正在运行的portal中。
resources目录下面提供了用于自定义装饰器和桌面主题的样本文件,拷贝到portlet/src/webapp下后进行修改即可。