本页采用了机器翻译。点击此处可查看英文原文。

编辑样式表数据项

内置样式表中的数据项类别

您可以编辑内置样式表中的数据项来自定义它们。数据项根据其功能出现在类别中。下表列出了 MATLAB® Report Generator™ 软件提供的每种样式表的类别和数据项。

PDF(FO) 样式表中的样式类别

类别类别数据项描述
自动标签列举报告各部分（如章和节）的选项
标注与标注相关的选项和规范，例如默认值、图形的使用、大小、路径、字体、字符和扩展名
交叉引用控制页码是否出现在报告中的选项
字体系列正文、版权、引文、符号、装饰符号、等宽字体、无衬线字体和标题的默认值规范
图形默认宽度和与缩放属性相关的选项的规范
列表与列表和列表项相关的间距规范
元数据/*信息与年份范围相关的选项
杂项标题、注释、变量列表、模块引用、ulink、URL 连字符、原样环境显示、SVG 使用、表脚注编号、上标和下标的放置选项和规范
分页和通用样式

页面方向、边距、双面、纸张类型、连字、行高、列、主字体、草稿模式、水印、空白页、页眉和页脚规则以及页眉和页脚内容的规范

注意

您可以指定此类别中的参数，例如边距宽度以及页眉和页脚高度，以英寸 (in)、毫米 (mm) 或派卡 (pc) 为单位，其中 1 派卡 = 1/6 英寸。

属性集与图窗标题、等宽属性、原样文本、章节标题和章节级别相关的规范和选项
参考页面控制是否显示类名的选项
样式表扩展行号和表列扩展
目录 (TOC)/表列表 (LOT)/索引生成目录布局、章节深度、缩进和边距的规范
表表及其边框的尺寸规范
标题页标题页元素定位、转换及标题页文本元素属性规范

有关 DocBook XSL 样式表的信息，请参阅 https://docbook.sourceforge.net/release/xsl/current/doc/。

您可以为非英语 PDF 字体设置字体映射。PDF 样式表覆盖了这些映射。有关详细信息，请参阅

HTML 中的样式类别和多页 HTML 样式表

风格分类类别数据项描述
自动标签列举报告各部分（如章和节）的选项
标注与标注相关的选项和规范，例如默认值、图形的使用、大小、路径、字体、字符和扩展名
分块与使用显式目录进行分块、部分分块深度、导航图形以及页眉和页脚中的标题显示相关的选项
样式表扩展行号、图形大小和表列扩展
图形指定默认宽度和深度、使用 HTML 嵌入 SVG、视口以及与缩放属性相关的选项
HTML与动态提供的 HTML、基本元素和头部元素、样式表类型、CSS、样式传播、longdesc、验证、清理、草稿模式、水印和摘要生成相关的规范
链接Ulinks 的 Mailto URL 和目标规范
元数据/*信息与年份范围相关的选项
杂项注释、原样环境像素、em 空间、SVG 的使用和表脚注编号的选项和规范
参考页面选项控制是否显示类名
目录 (TOC)/表列表 (LOT)/索引生成目录布局、章节深度、缩进和边距的规范
表表大小、表单元格间距和填充以及边框的规范
标题页标题页元素定位、转换及标题页文本元素属性规范
XSLT 处理与页眉和页脚导航和规则相关的选项

有关以下信息：

RTF(DSSSL) 样式表中的样式类别

风格分类类别数据项描述
提示框警告图形的选项和路径
后端Tex、MIF 和 RTF 后端使用选项
参考文献与检查引文相关的选项；抑制、列举和使用条目标题
字体某些元素使用的字体系列和大小的规范
脚注作为脚注和页面位置的 ulink 选项
图形文件扩展名、文件名和加载库数据库的规范
缩进悬挂缩进、首段和块开头的规范
标签枚举部分和其他元素
杂项浮动正式对象的选项、插入标题和敬语的标点符号、首次使用术语时加粗、行间最小行距以及自动连字符
Olink使用扩展查找大纲信息
对象规则规则位置和宽度的规范
纸张/页面特性纸张类型、页码、页面宽度、边距和栏目、标题级别、侧面以及书写模式（如从左到右）的规范
对齐段落对齐规范
参考条目和函数与函数参考条目和概要的生成和显示相关的选项
短标题生成和显示章节页眉的选项
目录 (TOC)/表列表 (LOT)生成或显示集合、书籍、部分、参考文献、文章的目录的选项。在标题页上显示目录的选项
表简单列表中的宽度规范
变量列表术语长度和格式的选项和规范
原样环境宽度、枚举、大小、缩进、行频率和标注的规范
垂直间距行距和段距规范

在简单或高级编辑模式下编辑数据项

  • 要在简单编辑模式下编辑数据项，请编辑与样式表中的数据相对应的简单文本值。该值出现在值标记右侧的字段中。对于某些值，使用选择列表来更改值，而不是输入文本。

  • 要在高级编辑模式下编辑数据项，请直接编辑 XML 代码。

注意

本节提供简单编辑模式的说明，除非另有明确说明。

当数据项出现在标有值的窗格中时，用户界面处于简单编辑模式。当数据项出现在标有值 (XML) 的窗格中时，它处于高级编辑模式。要从简单编辑模式切换到高级编辑模式，点击编辑为 XML。

在简单编辑模式或高级编辑模式下编辑 PDF 和 HTML 样式表中大多数数据项的值。仅在简单编辑模式下编辑 RTF 样式表的值。RTF 样式表中的数据项不支持高级编辑模式。

注意

要修改页眉和页脚的内容，您可以编辑样式表单元格，这些单元格在简单模式或高级模式下都不会出现。有关详细信息，请参阅页眉和页脚的样式表单元格。

数据项

从报告资源管理器中间的选项窗格中选择一个样式表。左侧的“大纲”窗格显示样式表内当前样式数据项的名称。中间的选项窗格显示可用样式表数据项的列表。右侧的属性窗格显示编辑样式表：数据。它还包括以下信息：

  • 数据项的值位于标有值（简单编辑模式）或值 (XML)（高级编辑模式）的窗格中。

  • 值的右边是编辑为 XML 切换按钮。

  • 预览窗格包含指定数据项的样式表的部分视图。此窗格中的数据不可编辑。

  • 帮助窗格包含有关数据项的信息。此信息不可编辑。

Report Explorer window. The window shows the Outline pane on the left with the name of the current style data item inside its style sheet. The Options pane in the middle shows a list of available style sheet data items. The Properties pane on the right displays Edit Style Sheet: Data

编辑布尔值和枚举值

在上图中，Show Comments 数据项的类型为 Boolean。其当前值为 true(1)。使用值字段的菜单列表更改此值。在这种情况下，唯一其他可能的值是 false(2)。

编辑值

对于某些数据项的值，报告资源管理器在可编辑的值字段中显示文本。您可以指定 XML 表达式，但这不是必须的。

编辑 XML 表达式

要对样式表进行复杂的更改，请考虑使用高级编辑模式。这使得您可以直接在值 (XML) 窗格中编辑 XML 表达式。如果此窗格未出现，点击编辑为 XML 切换到高级编辑模式。

确保您输入了有效的 XML。无效的 XML 值会产生错误，该错误会出现在“属性”窗格的顶部。

修改标题页属性

对于 PDF 或 HTML 样式表，您可以使用样式表编辑器修改标题页的布局、内容和格式。

  1. 在“大纲”窗格中，选择要编辑的样式表。

  2. 在“选项”窗格的标题 Page Templates 部分中，选择：

    • Book Titlepage Recto 指定标题页正面的属性

    • Book Titlepage Verso 指定标题页背面的属性

  3. 在“属性”窗格中，选择添加到当前样式表并编辑属性。

Report Explorer with Properties pane on the right showing Edit Style Sheet: Data

要调整用于在页面上定位标题页元素（例如标题和作者）的网格，请在“属性”窗格中指定：

  • 列 - 页面网格的列数

  • 宽度 - 每列的宽度

  • 行 - 页面网格的行数

  • 宽度 - 每行的宽度

要查看生成的标题页上的网格布局，请选择显示网格。

默认情况下，所有标题页元素都会出现在标题页上。要排除标题页元素的显示：

  1. 在“属性”窗格的在标题页面上包含列表中，选择要排除的元素。

  2. 点击右箭头按钮。该元素出现在从标题页面中排除列表中。

要指定单个标题页元素的属性：

  1. 在“属性”窗格的在标题页面上包含列表中，选择标题页元素。

  2. 调整适用的属性：

    • 布局选项--指定您希望元素出现在哪个标题页网格行和列中。要跨越多行或多列，请为纵跨行数和 Span column 属性指定数字。

    • 格式选项--对于文本元素，指定字体大小、是否使用粗体或斜体、文本颜色和文本对齐方式。

    • 转换选项 - 您可以使用这些选项指定 XSLT 代码来自定义标题页元素的内容和格式。使用 XPath 属性指定要修改的 XSLT 对象的路径。使用变换属性指定自定义内容和布局。

修改目录属性

要更改报告目录 (TOC) 生成的值，请从复选框矩阵中选择适当的值。

下图显示了 PDF 样式表上 Generate Toc 数据项的值。选中复选框来控制报告标题页和目录中显示的值。

Report Explorer showing the check boxes that are selected when Generate Toc is selected on the PDF style sheet

修改标题放置属性

标题 Placement 数据项属于其他类别，控制图窗标题的位置。

选择其中一个数据项进行编辑会导致右侧的“属性”窗格在菜单列表中显示可能的值。指定是否希望标题出现在给定图窗或表之前或之后。

修改属性

属性是指定 XML 元素信息的数据项。属性必须是属性集的子项。有关详细信息，请参阅编辑属性集。

注意

属性的“属性”窗格的帮助区域中的信息描述了该属性所属的集合。

编辑属性集

属性集由一组属性组成。在左侧的大纲窗格中选择一个属性集会导致属性窗格列出属于该集的属性。

要编辑特定属性，请展开“大纲”窗格中的属性集，然后选择要编辑的属性。

要编辑属性集，请在属性窗格的继承属性集区域中键入 text。

属性集的一个示例是 Formal Object Properties，它是 PDF 文档默认打印样式表的 Property Sets 类别中的数据项。

下面是报告资源管理器的示例，其中显示了属性窗格中的 Formal Object Properties 属性集。

Report Explorer showing the Formal Object Properties attribute set in the Properties pane

编辑 Varpair 值

RTF 样式表中的数据项显示为 varpair 数据项，它们是信息的名称/值对。RTF 样式表是唯一包含 varpair 数据项的样式表类型。

将 varpair 数据项编辑为字符向量或布尔值。布尔值显示为 true (#t) 和 false (#f)。

注意

您不能将 RTF 样式表数据项编辑为 XML。

注意

varpair 类型的数据有时在样式表中表示为 DSSSL 而不是 XML。因此，右侧“属性”窗格的预览窗格中显示的代码看起来与与其他类型的 MATLAB Report Generator 样式表相关的代码不同。

删除数据项

要删除自定义数据项：

  1. 右键点击左侧大纲窗格中的数据项。

  2. 选择删除。