WebSphere Portal 门户网站修改

WebSphere Portal 提供预定义的门户网站页面，其在安装和启动产品后立即可用。可以使用门户网站的基于 Web 的用户界面更改外观和感受，以切换到 WebSphere Portal 提供的其它预定义的可视元素和布局。下列主题描述如何修改门户网站页面，为门户网站站点创建您自已的可视元素和布局。

聚集概念
更改外观和感受
门户网站样式类
更改公司信息
更改门户网站页面帮助

聚集概念

门户网站应该为用户提供门户网站应用程序上的一致的视图，并允许用户定义特定的应用程序集，其以单个上下文提供给用户。取决于用户的设备，此应用程序集的提供必须变化以满足设备的要求。例如，考虑一组包含新闻、股票、天气和搜索的应用程序，其必须提供给使用声音交互作用的常规电话、具有有限的显示器和键盘的 WML 设备或基于浏览器的 PC。由于来自设备的每个请求而重复的聚集任务是：

收集有关用户、设备和所选语言的信息。
从用户具有访问权的应用程序集选择活动的 portlet。
聚集活动 portlet 输出到一致的、可使用的显示器。

一旦确定活动的页面，此页面的布局必须用于聚集定义的应用程序的内容、安排输出和集成每项内容到完整的页面。WebSphere Portal 提供门户网站数据库中拥有的页面描述符的页面的完全动态聚集。

页面组件的提供使用 JSP、图像、样式表和其它资源完成。这些资源定位在路径命名约定中的文件系统中，该约定是 Portal Server 用来定位客户机的正确资源。在设计自已的外观和感受、布局或支持其它标记语言或客户机之前，有必要理解这些资源的位置。

主题和外观

Portal Server 页面是使用门户网站的 Web 设计者或管理员定义的外观和主题显示的。主题表示门户网站的整个外观和感受，包括颜色和字体。例如，主题也用在导航栏中，来挑选页面选项卡角上的正确颜色图像。主题还包含用于定义门户网站组件的布局的 JSP 资源。WebSphere Portal 提供下列主题。

缺省主题
科学主题
工程主题
金融主题
公司主题

WebSphere Portal 还包含称为‘管理’的主题。此主题与提供无标题栏的 portlet 的‘无外观’外观关联。管理主题和“无外观”外观是为管理 portlet 提供的，并且不应用于门户网站站点中的其它位置或 portlet。

外观表示在独个的 portlet 周围呈现的边框。外观使用主题名称选择匹配主题颜色的图形。当所有标记都有外观时，仅 HTML 提供多个外观。WebSphere Portal 提供下列外观。

Album：	Clear：
Diamonds：	Fade：
Hint：	Noborder：
Noskin：	Outline：
Pinstripe：	Shadow：
Wave：

门户网站资源的搜索次序

聚集期间，Portal Server 从最特定子目录开始搜索，然后向上搜索更概括的，更高级别的目录来搜索主题和外观。

/themes 目录中的位置	/skins 目录中的位置
/`locale_country` /`locale` /`client` /`theme_name` /`markup`	/`locale_country` /`locale` /`client` /`skin_name` /`markup`

例如，从使用具有语言环境设置为 en_US 的 Internet Explorer 版本 5 并且用户的外观设置为“Shadow”的客户机获取一个请求。 Portal Server 的聚集组件将以下列次序搜索文件 Control.jsp。

 
1.  /skins/html/Shadow/ie5/en_US/Control.jsp
2.  /skins/html/Shadow/ie5/en/Control.jsp
3.  /skins/html/Shadow/ie5/Control.jsp
4.  /skins/html/Shadow/en_US/Control.jsp
5.  /skins/html/Shadow/en/Control.jsp
6.  /skins/html/Shadow/Control.jsp
7.  /skins/html/ie5/en_US/Control.jsp
8.  /skins/html/ie5/en/Control.jsp
9.  /skins/html/ie5/Control.jsp
10.  /skins/html/en_US/Control.jsp
11.  /skins/html/en/Control.jsp
12.  /skins/html/Control.jsp
13.  /skins/Control.jsp

在此示例中，如果在 ../ie5/en_US 目录中未找到文件，Portal Server 将在 ../ie5/en 目录中查找文件。 Portal Server 通过此层次结构继续移动直到找到此文件为止。如果必需该文件，它应该至少存在于 /skins 或 /themes 目录中，文件的更特定版本放在适当的子目录中。

更改外观和感受

理解 Portal Server 搜索资源的次序允许您创建自已的主题、外观和布局。另外，可以创建对使用门户网站站点的新客户机的支持，甚至设置对新标记语言的支持。在开始任何本节中描述的任务之前，请确保阅读了聚集概念。

定义您自己的主题
定义您自己的外观
定义对新客户机的支持
定义对新标记语言的支持

定义您自己的主题

定义您自己的主题涉及使用 wp_root/app/wps.ear/wps.war/themes/markup/ 目录中的主题名称创建子目录，以及在该目录中创建支持资源。HTML 是 WebSphere Portal 提供的唯一标记，其支持多个主题。下列步骤显示使用现有主题创建您自已的基于 HTML 的主题的一种方法。

使用新的主题名称创建新目录，例如，wp_root/app/wps.ear/wps.war/themes/html/MyTheme。
从另一个主题目录将所有文件和子目录复制到新目录。例如，可以从 /Science 主题复制文件。
JSP
Default.jsp、 Banner.jsp 和 Navigation.jsp 用于提供布局和确定屏幕元素的位置。请参阅更改门户网站布局，以获取有关如何定制这些内容的更为详细的信息。
图像
banner.jpg 是门户网站条幅使用的背景图像。 navfade.jpg 由左边的导航使用。可以修改这些图像或创建您自已的图像并将它们添加到 JSP。
样式表
Styles.css 是缺省样式表。对于进入 Internet Explorer 请求，使用 ie/Styles.css 样式表。可以更改标记定义以及在 CSS 样式表中的类定义。
使用门户网站管理添加新主题到门户网站站点。确保添加的主题名称与用于该主题的子目录名称相同。可以从门户网站设置页面添加主题和外观。请参阅管理主题和外观描述以获取更多的信息。
当处理新主题时，选择使用位置来测试并更改到新主题。请参阅使用位置，以获取更多的信息。
当准备为常规使用提供主题时，创建一个用户和管理员可以从位置或位置特性查看的预览。
1. 创建主题的屏幕图像。
2. 减少屏幕图像来适应预览框。建议大小为 300 x 225 像素。
3. 命名图像为 preview.gif。GIF 文件限制为 256 色。
4. 复制图像到 wp_root/app/wps.ear/wps.war/themes/html/theme_name。在我们的示例中，文件和位置为：wp_root/app/wps.ear/wps.war/themes/html/MyTheme/preview.gif。

定义您自己的外观

定义您自己的外观涉及使用 wp_root/app/wps.ear/wps.war/skins/markup/ 目录中的外观名称创建子目录，以及在该目录中创建支持资源。下列步骤显示使用现有外观创建您自已的基于 HTML 的外观的一种方法。

使用新的外观名称创建新目录，例如，wp_root/app/wps.ear/wps.war/skins/html/MySkin。
从另一个外观目录将所有文件和子目录复制到新目录。例如，可以从 /Fade 外观复制文件。
JSP
您要修改的唯一 JSP 是 Control.jsp，其用于提供页面上的每个 portlet。其余 JSP，如 RowContainer.jsp 和 ColumnContainer.jsp 由门户网站定制使用以安排页面中的 portlet。请参阅门户网站 JSP 使用的标记，以获取参考信息。
图像
这些是用于创建 portlet 标题栏或背景图像的图像。例如， title_edit.gif 用于提供打开 portlet 帮助方式的图标。可以修改这些图像或创建您自已的图像并将它们添加到 JSP。
使用门户网站管理添加新的外观到门户网站站点。确保添加的外观名称与用于该外观的子目录名称相同。可以从门户网站设置页面添加主题和外观。请参阅管理主题和外观描述以获取更多的信息。
当处理新的外观时，使用使用位置来测试并更改新的外观。请参阅使用位置，以获取更多的信息。
当准备为常规使用提供外观时，创建一个用户和管理员可以从位置或位置特性查看的预览。
1. 创建外观的屏幕镜头。
2. 减少屏幕图像来适应预览框。建议大小为 307 x 159 像素。
3. 命名图像为 preview.gif。GIF 文件限制为 256 色。
4. 复制图像到 wp_root/app/wps.ear/wps.war/skins/html/skin_name。在我们的示例中，文件和位置为：wp_root/app/wps.ear/wps.war/skins/html/MySkin/preview.gif。

定义对新客户机的支持

门户网站站点操作期间，您可能会发现某些用户已升级他们的浏览器，并且新的浏览器有一些 HTML 要求。或者，您可能会获取支持有特殊 WML 要求的新的移动电话的请求。在这两种情况下，您可以为客户机添加对门户网站站点的支持。如果新的客户机需要的标记不受门户网站站点的支持，则首先必须定义对新标记的支持。

要添加新的客户机，首先创建包含必需支持每个下列位置中的新客户机的资源的子目录：

wp_root/wps.ear/wps.war/app/screens

屏幕是 Portal Server 调用的 JSP，以显示各种内容。主屏是最常显示的，因为它用于 portlet 内容区域。其它屏幕包括登录或出错屏幕。请参阅更改门户网站布局，以获取更多有关屏幕的信息。

wp_root/wps.ear/wps.war/app/themes

除了 JSP，主题目录还可能需要图像、样式表或其它任何新的标记必需的文件类型。请参阅定义您自己的主题，以获取更多信息。

wp_root/wps.ear/wps.war/app/skins

请参阅定义您自已的外观，以获取有关外观目录中的资源的信息。

例如，要添加具有特定于 Netscape 6 浏览器的标记的条幅页面，您可以为下列位置中的每个主题创建 Banner.jsp：

  wp_root/app/wps.ear/wps.war/themes/html/theme_name/ns6

请参阅门户网站资源的搜索次序，以获取有关如何在目录结构中找到客户机资源的完整信息。

使用管理位置添加新的客户机到门户网站站点。确保添加的客户机名称与用于该客户机的子目录名称相同。可以使用门户网站设置页面添加新的客户机。

定义对新标记语言的支持

WebSphere Portal 支持 HTML、WML 和 cHTML 标记语言。如果要定义另一个支持的标记语言，必须确保具有提供该语言的标记的 portlet。另外，需要在下列每个位置中为标记创建子目录：

wp_root/wps.ear/wps.war/app/screens

wp_root/wps.ear/wps.war/app/themes

除了 JSP，主题目录还可能需要图像、样式表或其它任何新的标记必需的文件类型。请参阅定义您自己的主题，以获取更多信息。

wp_root/wps.ear/wps.war/app/skins

请参阅定义您自已的外观，以获取有关外观目录中的资源的信息。

请参阅门户网站资源的搜索次序，以获取有关如何在目录结构中找到客户机资源的完整信息。每个这些位置中的 JSP 必须提供新的标记语言必需的标记。

使用管理位置添加新的标记到门户网站站点。确保添加的标记名称与用于该标记的子目录名称相同。可以从门户网站设置页面添加标记。

门户网站样式类

WebSphere Portal 使用的样式表包含 portlet 可以用来确保页面上的各 portlet 之间的可视一致性的类。使用这些类确保无论选择的是什么主题，portlet 的外观和感受都匹配其它 portlet 和门户网站页面的外观和感受。

可以检查 wp_root/app/wps.ear/wps.war/themes/html/ 目录中的 Styles.css 文件来确定在 portlet 输出中调用的类。文件包含解释每个类的使用的注释。要找到 portlet 类，查找样式表中的下列注释。

/******************************************************************************/
/* portlet 中使用的样式                                                       */
/******************************************************************************/

更改公司信息

在门户网站页面的条幅中显示的文本在文件 engine.properties 中定义，其位于目录 ../AppServer/lib/app/nls 中。对于使用多种语言的站点，文件可以有相应于语言环境的语言后缀，例如 engine_es.properties 适用于西班牙语。如果 WebSphere Portal 无法确定客户机语言环境，条幅文本在 engine.properties 中定义。使用下列步骤来为每个门户网站站点支持的语言更改条幅文本。

编辑文件 engine.properties。
将 title 参数更改为您想要在门户网站条幅中显示的名称。
保存和关闭 engine.properties。
重新启动 WebSphere Portal 的应用程序服务器。

许可证协议和隐私策略文件包含应更改为包含您公司特有的相关内容的信息。这些文件分别是 license.html 和 privacy.html，位于 wp_root/app/wps.ear/wps.war/html 目录中。

更改门户网站页面帮助

WebSphere Portal 为门户网站提供了帮助信息。可以定制此帮助页面来反映关于您组织站点的内容和信息。门户网站帮助是 HTML 和图像文件的集合。帮助页面包含有关管理门户网站的信息。此信息可从门户网站导航栏中的帮助链接访问。要阻止访问管理信息，可以更改链接以访问另一个帮助文件集或除去文件中提供的链接。

要更改帮助链接，编辑为您使用的每个主题提供的 JSP 中的链接。请参阅定义您自己的主题，以获取更多信息。

要更改现有帮助文件，查找下列路径中的文件：

 
wp_root/app/wps.ear/wps.war/doc/locale/InfoCenter/help

其中 wp_root 是 WebSphere Portal 根目录，locale 表明语言。

主门户网站帮助文件是 wp_root/app/wps.ear/wps.war/doc/locale/InfoCenter 目录中的 help_index.html。该文件设置条幅、导航和帮助内容的框架。当添加新的帮助内容时，需要更新 navText.txt 和 htmltoc.html，以链接到新的文件。

原始帮助可用于多种语言。如果用户需要支持多种语言，将需要转换创建的任何新文件。在进行更改之前，请为原始帮助创建一个备份副本。