选择报告生成选项
报告选项对话框
要为报告指定报告生成选项,请在报告资源管理器中使用报告选项对话框。从大纲视图中选择报告时,将出现“报告选项”对话框。
要设置这些选项的默认值,请使用“报告生成器”设置。详情请参阅 H。
如果您正在创建基于表单的报告,请使用“报告表单选项”对话框。请参阅报告表单。
报告输出文件的位置
选择一个文件夹来存储报告文件。您必须具有该文件夹的写入权限。
文件夹
在报告资源管理器的报告选项对话框中,使用目录字段指定存储生成的报告文件的文件夹的名称。指定您有写入权限的文件夹。
下表总结了报告文件位置选项。
文件夹 | 选项 |
---|---|
与报告设置文件相同的文件夹 |
|
当前工作文件夹 |
|
临时文件夹 |
|
另一个文件夹 |
使用浏览按钮(...)从目录列表中选择。 |
您可以使用 %<VariableName>
符号在自定义文本框中指定一个文件夹。
报告文件名
在报告资源管理器的报告选项对话框中,使用文件名字段指定报告文件的文件名。选择以下选项之一。
文件名 | 选项 |
---|---|
与报告设置文件相同的文件名 |
|
文件名与报告设置文件名不同 |
输入报告的名称。 |
您可以使用 %<VariableName>
符号在自定义文本框中指定文件名。
增加以防止覆盖
若要在保存设置文件更新时保留设置文件的先前版本,请选择如果报告已存在,则递增报告编号以防止覆盖。
图像输出文件位置
图像放置在与报告文件同名的文件夹中。例如,testreport.html
图像放在名为 testreport_files
的文件夹中。
报告输出格式
在报告输出类型和样式表下,从文件格式列表中选择报告输出格式。您可以生成基于模板或基于报告资源管理器样式表格式的报告。
使用报告模板的文件格式
为了更快地生成报告,请设置文件格式以使用模板。选择以下选项之一:
Acrobat (PDF)
直接 PDF (来自模板)
直接 PDFA (来自模板) (自 R2025a 起)
HTML (来自模板) - 如果您希望报告的目录展开和折叠,请选择此选项。
多页 HTML (来自模板) - 如果您希望 HTML 报告作为 HTML 页面的链接集合,请选择此选项。 (自 R2024a 起)
PDF (来自 Word 模板)
单文件 HTML (来自模板) - 如果您希望报告的目录展开和折叠,并且希望 HTML 报告作为单个文件,请选择此选项。
Word (来自模板)
Word (RTF)
Web (HTML) - 基本 HTML 页面
如果您选择基于模板输出格式,那么您可以使用默认模板或自定义模板。有关使用模板生成报告的更多信息,请参阅 使用模板生成报告。有关自定义模板的信息,请参阅 自定义报告转换模板。
使用报告资源管理器样式表的文件格式
名称中不包含基于模板的输出格式使用报告资源管理器样式表进行格式化。对于那些输出格式,从样式表列表中选择一个样式表。
查看器 | 格式 | 描述 | 样式表 |
---|---|---|---|
Adobe® Acrobat® 阅读器 | Adobe Acrobat (PDF) | 生成一份您可以使用 Adobe Acrobat 阅读器软件查看的 PDF。 请参阅PDF:图像格式。 | PDF(请参阅PDF 样式表) |
Word 处理器 |
| 生成与大多数文字处理软件包兼容的输出,包括 Microsoft® Word 软件 请参阅RTF:隐藏内容的显示。 | Print(请参阅RTF(DSSSL 打印)和 Word 样式表) |
DocBook | DocBook (no transform) | 生成 DocBook 格式的报告 | 不适用 |
提示
要创建和使用自定义样式,请参阅 创建新的样式表。
PDF:图像格式
PDF 报告仅支持 JPEG
(.jpg
) 和可缩放矢量图 (.svg
)。
SVG 格式仅支持 Simulink® 模型和 Stateflow® 图。例如,当您为 PDF 报告选择 SVG 格式时,MATLAB® 图窗不会以 SVG 格式显示。
RTF:隐藏内容的显示
RTF 报告使用占位符(字段代码)来表示动态生成的内容,例如页码或图像。
在 Windows® 平台上,要显示该内容,请按 Ctrl+A,然后按 F9。
在 Linux® 和 Mac 平台上,使用您用于查看 RTF 文档的程序的字段代码更新接口。
更改默认输出格式
在 Report Generator 设置窗格中,使用格式 ID 设置指定报告的默认输出格式。
样式表
对于每种输出格式,您可以从每种报告输出格式的多个样式表中进行选择。有关详细信息,请参阅:
注意
一些 Web 和打印样式表包含生成的标题列表,其中包括表标题和带有标题的图窗。
PDF 样式表
PDF 样式表 | 描述 |
---|---|
| 显示标题页、目录、标题列表 |
| 显示标题页、目录、标题列表 |
| 隐藏标题页面、目录、标题列表 |
| 最小化页数,隐藏标题、目录和标题列表 |
| 使用 12 号字体(比标准打印略大) |
| 使用 24 号字体和横向纸张方向 |
| 最小化空白以减少页数 |
| 使用未编号的章节 |
| 使用编号章节 |
| 打印带分页符的节 |
| 允许您指定自定义页眉和页脚 |
| 允许您指定自定义标题页内容和演示 |
| 允许您指定高级打印选项 |
网页样式表
网页样式表 | 描述 |
---|---|
| 只有一个单页的 HTML 文档 |
| 多页 HTML;隐藏章标题和目录 |
| 多页 HTML;隐藏章标题和目录 |
| HTML,每章单独一页 |
| 只有一个单页的 HTML 文档 |
| 单页 HTML;章节未编号 |
| 单页 HTML;章节均已编号 |
| 单页上的 HTML;隐藏标题页和目录 |
| 多页上的 HTML;隐藏标题页和目录 |
| 多页 HTML;章节未编号 |
| 多页 HTML;章节均已编号 |
RTF(DSSSL 打印)和 Word 样式表
RTF 或 Word 样式表 | 描述 |
---|---|
| 显示标题页、目录、标题列表 |
| 隐藏标题页面、目录、标题列表 |
| 最小化页数,隐藏标题、目录和标题列表 |
| 使用 12 号字体(比标准打印略大) |
| 使用 24 号字体和横向纸张方向 |
| 最小化空白以减少页数 |
| 使用未编号的章节 |
| 使用编号章节 |
报告生成处理
报告选项对话框包括用于控制报告处理的选项。
选项 | 用途 |
---|---|
生成后查看报告 | 报告生成完成后,与报告输出格式关联的查看器将显示该报告。 在 Linux 或 Macintosh 平台上打开 Microsoft Word 文档会调用 要手动查看报告,请从报告的报告选项中指定的位置(报告文件位置下)打开文件。 |
生成前自动保存 | 在生成报告之前自动保存报告设置文件。 |
编译模型以报告编译的信息 | 确保报告反映编译的值。 默认情况下,Simulink Report Generator™ 报告 Simulink 参数的未编译值。某些参数的未编译值(例如信号数据类型)可能与仿真期间使用的编译值不同。 此选项使报告生成器在报告模型参数之前编译模型。生成报告后,报告生成器将模型返回到未编译状态。 注意 当您选择此选项时,每当报告生成需要仿真模型时(例如,报告包含模型仿真 (Simulink Report Generator)组件),报告生成器都会反编译该模型,然后重新编译该模型(如有必要),以报告模型内容。如果一份报告需要多次编译,处理起来会非常耗时。 为了尽量减少编译,请考虑使用单独的报告来报告模型的内容和对该模型进行仿真的结果。 |
生成后计算此字符串 | 指定 MATLAB 代码以便在报告生成后进行处理。例如,您可以指定关闭一个模型。 |