IBM Portal 7主题开发入门-PageBuilder2
1.1 简介
IBM WebShere Portal 7相对于之前版本最大的变化就增加了新的皮肤开发模式-PageBuilder2,官方翻译叫"页面构建器"。它同时支持旧的主题开发模式。新模式主要的改变就是将样式与页面布局分开了，同样页面布局可以应用不同的样式，就像WinXP的桌面主题，因此也带来了复杂性。
1.2 类型
PageBuilder2主题开发模式分为两种：
第一种： 样式+war包式。
第二种： 独立war包式。
其中第一种的war包是非必须的，如果不想改变缺省的面布局及内容，你只需修改样式并共享产品自带的war包即可。
1.3 步骤
下面分别详细介绍一下。
我的wp7是装在windows2003上的。
1.3.1 样式+共享war包式
开始之前需要准备一款WebDAV客户端工具（WebDAV我就不赘述了，搜狗（^0^）一下），我选择的是一个免费的由Java开发的工具“AnyClient”（见附件）。AnyClient需要jre，最低1.5，最高1.6（1.4可打开，但运行异常）。
1）使用AnyClient连接Portal的WevDAV目录。
连接地址为 http://localhost:10039/wps/mycontenthandler/dav/themelist/。
注意：
wps为上下文根，缺省名字为wps，如果你已经改变了文根，请将wps替换为你自定义的文根。
提示：
用户名与密码就是Portal was控制台的管理员和密码。如果你在Win7下使用Anyclient，请将窗口主题切换为“windows经典”，否则AnyClient窗口将会是一个大白板。
连接WebDAV时可能会很慢，要耐心等...!
2）拷贝themelist/目录下的csa2.theme目录到本地。
3）修改下载的csa2.theme文件夹为你喜欢的名字，如：my_theme。
4）修改\metadata\localized_zh.properties文件内的title属性。
写个你喜欢的名字吧，最好是英文的（不能直接写中文，需要编码，非必须就别给自己找麻烦了^_^） 。
5) 将你修改好的主题文件夹利用AnyClient传输到themelist/文件下。
6）传输完成后，你就已经有一个新的主题可选了。
提示：
很显然，你在主体管理工具那是看不到新的主题的，这时你需要任意选择一个主题，点击编辑，然后再点一下保存，这样会强制wp刷新主题列表缓存，你新建的主题就出来了。
总结：
这种方式创建的新主题与wp7自带的主体样式是一样的（复制的嘛），并且共享Jsp页面文件。也就是你只能修改样式。说实话，我感觉真挺不好改的，主题里全是css与js，不知从何改起，我是没再深研究。
1.3.2 样式+独享war包式
如果想修改页面的布局与内容，你需要使用自己的主题war包。方法还是一样：复制并改名在传回去。
1）复制PageBuilder2 war包并改个名字。
路径为：wp7安装目录+\IBM\WebSphere\PortalServer\theme\wp.mashup.cc.theme\ installedApps\wp.mashup.cc.theme.ear\PageBuilder2.war
2）删除 ./skins 目录下的所有文件。
3）修改./themes/html/目录下的PageBuilder2文件夹的名字，如：my_pb2，以下都用my_pb2代表你喜欢的名字。
4）在WEB-INF文件夹里删除plugin.xml文件，别的文件不用删。
5）修改web.xml里的display-name属性为my_pb2。
6）修改ibm-web-bnd.xmi 与 ibm-web-ext.xmi 文件。
ibm-web-bnd.xmi修改位置为：<webapp href="WEB-INF/web.xml#my_pb2"/>
ibm-web-ext.xmi修改位置为：<webApp href="WEB-INF/web.xml#my_pb2"/>
7）将修改完的文件打成war包，部署到wp7的was控制台。
注意：
发布时，进行到映射服务器那步时，一定要选择WebSphere_Porta，系统自动选择的那个是错误的。
记住你在部署时输入上下文根路径如：my_pb2。
8）测试新部署的主题war包。
访问： http://localhost:10039/wps/my_pb2/dav/themelist/customTheme/
如果页面报500错误，证明你已经部署成功了。因为它缺少Portal环境，所以报错。
9）利用xmlaccess 导出主题部署信息。
xmlaccess在中文版中叫“导入xml”，菜单位置在portal后台管理左树－〉门户网站设置－〉导入xml。
将以下xml内容保存为一个文件，使用xmlaccess导入portal。
<?xml version="1.0" encoding="UTF-8"?> <request xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="PortalConfig_7.0.0.xsd" type="export" create-oids="true"> <portal action="locate"> <theme action="export" objectid="*" /> </portal> </request>
10）导入成功后，你会得到返回的xml字符串，保存为本地文件并修改其中的内容。
修改其中的 context root, resource root, uniquename与为“my_pb2”如：
<theme action="update" active="false" context-root="/my_pb2" default="false" domain="rel" objectid="ZJ_618LOIP300NI60IE2H5GHD3001" resourceroot="my_pb2" uniquename="my_pb2">
11）将修改完的文件利用xmlaccess导入回去。
12）修改样式包里的 theme.html 文件。
利用用AnyClient下载到本地修改在传回覆盖原文件。
样式包就是在1.3.1中我们自己创建的那个样式文件夹（my_theme）。
还是要修改上下文根为“my_pb2”如：
替换以下内容：
<link rel="dynamic-content" href="dyn-cs:id:head@tl:oid:csa2.theme">
为:
<link rel="dynamic-content" href=" res:/my_pb2/themes/html/my_pb2/head.jsp">
同样的，在theme.html中查找包含“rel="dynamic-content" ”的标签，根据 href属性中位于“id：”与"@"符号之间的内容，替换href属性内容：
<a rel="dynamic-content" href="dyn-cs:id:bannerNav@tl:oid:csa2.theme">
根据红色字体，替换href属性：
<a rel="dynamic-content" href="res:/my_pb2/themes/html/my_pb2/bannerNav.jsp">
需要替换的所有jsp页面列表如下：
res:/customTheme/themes/html/customTheme/bannerNav.jsp
在/nls文件夹下还有一个theme_zh.html文件，也需要按照以上步骤修改。
总结：
完工了，现在就可以在主题管理里面使用新的皮肤了，显然它和缺省皮肤一样。如果只需要改样式，则修改样式文件，然后用WebDAV工具上传更新；如果要改变页面格局及内容，则需要修改样式war包中的jsp。
1.3.3 独立war包式
抱歉没有亲自实践，不敢乱写，请参考下面列出的文档吧，
《Consolidated Steps for Creating Custom Themes in WP7 》里面有简单的介绍。
2 参考文档
Creating a new PageBuilder2 custom theme: wp7
How to deploy a theme as a custom war into WebSphere Application server console
Consolidated Steps for Creating Custom Themes in WP7
后记：
这篇文章大都是翻译而来，其中添加了我遇到的一些问题及解决方法。次篇只是抛砖引玉，入门而已。再多讨论请查阅IBM的信息中心：
欢迎转载，请注明出处，谢谢！