设计模板的 HTML 输出参考

复审此信息以了解有关如何使用 Rational® Publishing Engine 来生成 HTML 文档的更多信息。

用途

将模板输出为 HTML Web 页面。

受支持的内容查看器

要获取查看此输出类型时支持的产品的列表,请执行下列操作:
  1. 打开Rational Publishing Engine的系统要求
  2. 按类型部分中,单击软件
  3. 滚动到内容查看器部分。 系统会列示查看 Rational Publishing Engine 输出时支持的产品名称和版本。

模板元素

表 1. 可用于 HTML 输出格式的模板元素
元素 描述 可以包含其他元素 可以包含内容值和表达式

“段”图标

用来对元素部分进行分组。在输出中其子元素周围添加一个回车符。

“容器”图标 容器

用来对元素部分进行分组。无法设置样式,因此不会影响输出的格式。

在其他元素内部使用时,可用于容器的子元素可能受限。例如:
  • 在行内部,容器只能主管单元格
  • 在列表内部,容器只能主管列表细节元素

“文本”图标 文本

内容以相同的指定格式进行呈现。

“具有样式的文本”图标 具有样式的文本

文本块中的个别单词可以具有独特的格式。对元素中的所选单词使用粗体、斜体、下划线、删除线或颜色格式。文本是静态的。

“超链接”图标 超链接

在输出中创建超链接。超链接可以指向文档内部的位置,也可以指向外部位置。

“图像”图标 图像

在输出中显示 .gif.png.jpgemfwmf 图像。图像路径可以由报告设计者在模板中指定,也可以由报告生成者在运行时指定。

“表”图标

在输出中创建表。表可以包含行元素或容器元素。

“行”图标

在当前表中创建行。

“单元格”图标 单元格

在当前表的当前行中创建单元格。

“列表”图标 列表

在输出中创建项目符号列表或数字列表。

“列表细节”图标 列表细节

在输出的当前列表中创建列表项目。

“数据源配置”图标 数据源配置

请参阅添加数据源配置元素

“包括文件”图标 包括文件

将输出中的指定文件包括为 INCLUDETEXT 字段。

  • 包括的文件可以具有 .doc.docx.txt.rtf 扩展名。
  • 对于 Microsoft Word 输出,必须更新包含宏的所有字段,才能看到包括的文件。
  • 对于旧 PDF、HTML 和 XSL-FO 输出,包括的文件是文档的超链接。

“书签”图标 书签

在文档中定义书签。所生成的书签的名称是书签的内容。生成文档时,Rational Publishing Engine 会为每个书签生成唯一名称。该名称基于设计时提供的名称,并且是运行时生成的唯一标识。

“分页符”图标 分页符

在输出中添加分页符。

“分节符”图标 分节符

在输出中添加分节符。

“目录”图标 目录

在输出中添加目录。

元素属性

复审这些备注以了解有关在专门为生成 HTML 文档而设计的模板中指定元素属性的更多信息。
表 2. 单元格属性
单元格属性 注释
边框宽度 必须为边框宽度指定值才能在输出中创建边框。
单元格对齐 此属性指定文本在单元格中的位置。
单元格宽度 您可以指定单元格宽度(以像素、磅数或百分比计)。
表 3. 图文字说明属性
图文字说明属性 注释
边框宽度 必须为边框宽度指定值才能在输出中创建边框。
字段代码 请不要用于此输出格式。
表 4. 图像属性
图像属性 注释
边框宽度 必须为边框宽度指定值才能在输出中创建边框。
内容 受支持的图像格式:
  • Internet Explorer:.bmp.emf.gif.jpg.png.svg(V9 和更高版本)以及 .wmf
  • Firefox:.bmp.gif.jpg.png.svg
表 5. 列表详细信息属性
列表详细信息属性 注释
边框宽度 必须为边框宽度指定值才能在输出中创建边框。
表 6. 页码属性
页码属性 注释
边框宽度 必须为边框宽度指定值才能在输出中创建边框。
表 7. 段属性
段属性 注释
边框宽度 必须为边框宽度指定值才能在输出中创建边框。
段落对齐 使用特定对齐方式给页面上的文本添加间隔。

Leftrightcenter 对齐会创建不规则的段边缘,让段容纳尽可能多的字。Justify 会通过在所有行(最后一行除外)上的字之间插入额外间隔来创建规则段边缘。 Distributed 类似于 justify,但不同之处在于,也会在段的最后一行上的两个字之间插入该间隔。

未排足行/孤立字控制 请不要用于此输出格式。
表 8. 行属性
行属性 注释
分页换行 请不要用于此输出格式。
表 9. 表属性
表属性 注释
自动适合内容 调整表的大小以适合每个单元格包含的内容。使用此属性时,也请将根据内容调整大小属性设为 true
边框宽度 必须为边框宽度指定值才能在输出中创建边框。
单元格间距 请不要用于此输出格式。
列中的固定单元格宽度 指定值(以像素计)以确保列中的所有单元格都具有相同的宽度。
根据内容调整大小 如果设为 true,那么不会换行,除非存在空格。如果没有空格,那么不会换行,并且会将列宽增大为文本的宽度。如果设置自动适合内容,那么必须将根据内容调整大小设为 true

如果设为 false,那么会固定列宽并且换行,而不管使用的空格或文本长度。此外,会忽略表自动调整属性。

表自动调整 如果设为 true,那么会调整表的大小以适合页面的宽度。如果根据内容调整大小也设为 true,那么会忽略单元格宽度并调整表格的大小以与内容匹配。

不能输入 fixed column width 作为值。请改用 fixed cell width 属性。

表 10. 表文字说明属性
表文字说明属性 注释
边框宽度 必须为边框宽度指定值才能在输出中创建边框。
字段代码 请不要用于此输出格式。
表 11. 文本属性
文本属性 注释
边框宽度 必须为边框宽度指定值才能在输出中创建边框。
表 12. 总页数属性
总页数属性 注释
边框宽度 必须为边框宽度指定值才能在输出中创建边框。

包含文件元素

您可以选择链接该文件,也可以选择将该文件以物理方式嵌入输出文档。但是,处理包含文件元素的方式取决于输出格式以及您从中检索文件的位置。 对于旧 PDF、HTML 和 XSL-FO 输出,包含的文件总是超链接。

标题样式

要使用 HTML 的预定义标题样式(H1、H2 ...、H9),请使用样式名称 1、2 至 9。

Rational Publishing Engine 样式与外部样式

请尽可能使用在样式表中定义的外部样式。此方法可让您快速更改输出文档的外观,并在公司实施一致的外观。

输出中的 Unicode 数据

如果使用的字体支持 Unicode,那么会呈现所有 Unicode 数据。对于 HTML 输出,如果使用了非 Unicode 字体,请在生成文档之后在样式表中更改字体系列。

OLE 对象

可从数据源中的属性抽取嵌入式对象,例如对象链接与嵌入(OLE 对象)。但是,OLE 对象总是呈现为 HTML 输出中的图像,因为该格式不支持 OLE 对象。

段落中的列表

当您正在设计用于生成 HTML 输出的模板时,请避免在段元素中嵌套列表元素。

列表会继承影响某些段落属性的格式属性的指定集合。例如,当段落包含列表时,如背景色和边框这样的段落属性会受到影响。将模板中的列表元素放置段元素之后,以避免出现这些问题。


反馈