在仪表板空间中定制主题

主题定义空间的总体结构、外观和行为。缺省情况下，所有空间使用产品随附的标准主题。您可以创建一个或多个定制主题，以替换或扩充此缺省主题。

关于此任务

主题是一组功能强大的编程工件，可用于控制页面在空间中如何显示的每个方面。但是，对于大多数定制目的（例如，更改空间中使用的颜色或图像），可以考虑定制要用于空间的样式而非创建新主题。定制空间的主题是一项复杂得多的任务，并可能对空间维护、迁移和升级到更高产品版本等方面存在影响。有关定制样式的更多信息，请参阅创建和定制仪表板空间的样式。

要点：定制主题之前，请注意以下两点：

定制主题需要熟悉 HTML、CSS、JavaScript、iWidget 规范和 Dojo 窗口小部件库。
如果定制主题，那么在常规服务或维护活动期间，将不会应用对缺省主题工件的任何 IBM® 更新。定制主题必须手动进行更新和维护。

以下文件和文件夹定义并控制空间的主题。

表 1. 主题文件和文件夹
文件或文件夹名称	描述
theme.html	主题主要由 theme.html 文件定义。此文件包含四种类型的元素：标记代码定义页面总体结构的静态标记代码。可以修改此代码以定制页面的构造和组织方式。 JavaScript 代码定义页面级别脚本编制逻辑的 JavaScript 代码。可以添加更多 JavaScript 来扩展现有页面行为。动态内容点定义将添加从服务器端 JavaServer 页面 (JSP) 文件所生成内容的位置的特殊标记。管理员使用管理控制台来映射内容点标识和 JSP 页面。以下示例说明动态内容点： `<link rel="dynamic-content" href="dyn-cs:id:head@tl:oid:csa2.theme">` 可以添加、除去、替换或隐藏动态内容点。系统窗口小部件标记引用窗口小部件描述符的特殊标记（iWidget 2.1 规范）。窗口小部件在创建时带有客户端 JavaScript 处理能力，然后动态添加到所定义区域中的文档对象模型 (DOM)。窗口小部件工件可以部署为 Java EE WAR 文件，也可以直接部署在 WebDAV 中。以下示例说明系统窗口小部件标记： `<div class="iw-iWidget iw-Standalone" id="modeSelector"> <a clas="iw-Definition" href="/BusinessSpace/iWidget/widgets/system/modeSelector/modeSelector.xml"> </div>` 可以添加、除去、替换或隐藏系统窗口小部件。
embed.html	theme.html 的简化版本，此文件包含带有窗口小部件的主 lotusFrame 标记，并在页面嵌入在其他 Web 页面中时用于显示内容区域。
metadata.properties	包含主题识别信息的属性文件。
theme.css 和 bspaceCustom.css	控制主题外观的样式表。如果打算对主题进行样式更改，那么需要编辑这些文件或者创建其他 CSS 文件作为 theme.css 和 bspaceCustom.css 的同级文件。
banner	此文件夹包含条幅定制所需的动态内容。
images	此文件夹包含主题中使用的图像。
menuDefinitions	此文件夹包含用于定制上下文菜单中内容的 JavaScript 对象表示法 (JSON) 文件。
metaData	此文件夹包含 localized_en.properties 文件，它定义为此空间选择主题下拉菜单中显示的主题名称。
spaceStyles	此文件夹包含用于为界面应用不同样式的 JavaScript 文件和子文件夹。
Standard	此文件夹包含窗口小部件的标准外表。如使用此外表，各窗口小部件周围带有边框，顶部会显示工具栏，其中包含用于最小化、最大化和恢复窗口小部件大小的上下文菜单和图标。
Thin	此文件夹包含隐藏边框和工具栏的窗口小部件外表。

下一步做什么

要对可用主题进行更改，请重新启动托管仪表板空间的服务器。