发布的输出首选项
如何编辑发布选项
如果您的代码不需要输入参数,并且希望将其发布到HTML,则使用默认的发布首选项。但是,如果代码需要输入参数,或者希望指定输出设置、代码执行或图形格式,则需要指定自定义配置。
去发布选项卡,选择发布.
选择编辑发布选项.
在“编辑配置”对话框中,指定输出首选项。
使用MATLAB的表情窗格中指定发布期间执行的代码。使用发布设置窗格以指定输出、图形和代码执行选项。
这些窗格一起组成了MATLAB®简称为发布配置.MATLAB将每个发布配置与
.m
文件。发布配置的名称显示在对话框的顶部,并且是可编辑的。
指定输出文件
控件上指定输出格式和位置发布设置窗格。
MATLAB发布为这些格式。
格式 | 笔记 |
---|---|
超文本标记语言 |
发布到HTML文档。您可以使用可扩展样式表语言(XSL)文件。 |
xml |
发布到XML文档。您可以使用可扩展样式表语言(XSL)文件。 |
乳胶 |
发布到LaTeX文档。做不保留语法高亮显示。您可以使用可扩展样式表语言(XSL)文件。 |
医生 |
发布到微软®词文档。做不保留语法高亮显示。此格式仅在Windows上可用®平台。 |
ppt |
发布到微软演示文稿®文档。做不保留语法高亮显示。此格式仅在Windows平台上可用。 |
pdf |
发布到PDF文档。 |
请注意
XSL文件允许您更好地控制输出文档的外观。详情请参见http://docbook.sourceforge.net/release/xsl/current/doc/.
在发布期间运行代码
指定的代码
默认情况下,MATLAB执行.m
要发布的文件。中指定任何有效的MATLAB代码MATLAB的表情窗格。例如,如果您想发布一个需要输入的函数,那么运行该命令
.您希望发布其输出的其他代码出现在函数调用之后。如果你清除MATLAB的表情区域,然后MATLAB发布文件,而不计算任何代码。函数
(输入
)
请注意
发布配置使用基本的MATLAB工作空间。因此,变量在MATLAB的表情窗格将覆盖基本工作区中现有变量的值。
评估代码
影响MATLAB在发布期间执行的另一种方法是设置评估代码选项中的发布设置窗格。此选项指示MATLAB是否计算对象中的代码.m
正在发布的文件。如果设置为真正的
, MATLAB执行代码并将结果包含在输出文档中。
属性时,MATLAB不计算代码也不包括代码结果评估代码选项假
,则文件中可能有无效代码。因此,请考虑首先运行该选项设置为的文件真正的
.
例如,假设您包含注释文本,标记地块
,但是忘记在它前面加上注释字符。如果将文档发布为HTML,并设置评估代码选项真正的
,则输出包含错误。
使用假
选项,以发布包含发布
函数。否则,MATLAB将尝试递归地发布该文件。
包括代码
您可以指定是否在最终输出中显示MATLAB代码。如果你设置包括代码选项真正的
,然后MATLAB将代码包含在已发布的输出文档中。如果设置为假
, MATLAB排除所有输出文件格式的代码,除了HTML。
如果输出文件格式是HTML, MATLAB将代码作为HTML注释插入,在web浏览器中不可见。如果您想从输出HTML文件中提取代码,请使用MATLABgrabcode
函数。
例如,假设您要发布H: / my_matlabfiles / my_mfiles / sine_wave.m
属性的发布配置转换为HTML包括代码选项设置为假
.如果您与同事共享输出,他们可以在web浏览器中查看。要查看生成输出的MATLAB代码,可以从包含sine_wave.html
:
grabcode(“sine_wave.html”)
sine_wave.html
在编辑中。
发现错误
您可以捕获并发布发布过程中发生的任何错误。设置捕获错误选项真正的
包括输出文档中的任何错误消息。如果你设置捕获错误来假
,如果在代码求值过程中发生错误,MATLAB将终止发布操作。但是,如果您设置了评估代码财产假
.
限制输出量
属性可以限制输出文档中包含的代码输出行数最大输出行数选项中的发布设置窗格。如果一个较小的、有代表性的代码输出示例就足够了,那么设置这个选项是有用的。
例如,下面的循环在已发布的输出中生成100行除非最大输出行数设置为较低的值。
对于n = 1:100 disp(x)结束;
在发布输出中操纵图形
选择图像格式
在发布时,您可以选择MATLAB用于存储代码执行期间生成的任何图形的图像格式。下拉列表中可用的图像格式取决于图捕获法选择。为了获得最大的兼容性,请选择本表中指定的默认值。
输出文件格式 | 默认图像格式 | 可以包含的图像类型 |
---|---|---|
医生 |
png |
您安装的任何版本的格式微软办公软件万博1manbetx支持。 |
超文本标记语言 |
png |
所有格式成功发布。确保用于查看和处理输出文件的工具能够显示指定的输出格式。 |
乳胶 |
png 或epsc2 |
所有格式成功发布。确保用于查看和处理输出文件的工具能够显示指定的输出格式。 |
pdf |
骨形态发生蛋白 |
|
ppt |
png |
您安装的任何版本的格式微软办公软件万博1manbetx支持。 |
xml |
png |
所有格式成功发布。确保用于查看和处理输出文件的工具能够显示指定的输出格式。 |
设置图像大小
在MATLAB中设置生成图像的大小发布设置窗格中的“编辑配置”对话框窗口。您可以指定图像大小(以像素为单位),以限制输出图像的宽度和高度。像素值作为最大尺寸值,因为MATLAB维持图像的纵横比。MATLAB在以下情况下忽略大小设置:
中所述的外部图形时外部图形
当使用矢量格式时,例如
.eps
当发布到
. pdf
捕获的数据
属性可以捕获“图”窗口的不同方面图捕获法选择。此选项确定“图”窗口的窗口装饰(标题栏、工具栏、菜单栏和窗口边框)和绘图背景。
下表总结了各种图捕获方法的效果。
使用此图形捕获方法 | 使用这些外观细节获取图形捕获 | |
---|---|---|
窗口装饰 | 情节背景 | |
entireGUIWindow |
包括对话框;数字不包括在内 | 数字设置为白色;匹配对话框的屏幕 |
打印 |
对话框和图形排除 | 设置为白色 |
getframe |
对话框和图形排除 | 与屏幕图背景相匹配 |
entireFigureWindow |
包括对话框和图形 | 与屏幕图背景相匹配 |
请注意
通常,MATLAB图形有HandleVisibility
属性设置为在
.对话框是带有HandleVisibility
属性设置为从
或回调
.如果您的结果与上表中列出的结果不同,请使用HandleVisibility
属性可能是非典型的。有关更多信息,请参见HandleVisibility
.
指定自定义图形窗口
MATLAB允许您为它创建的图形指定自定义外观。如果使用新数字选项中的发布设置窗格设置为真正的
,然后在发布的输出中,MATLAB使用默认大小和白色背景的Figure窗口。如果使用新数字选项设置为假
,然后MATLAB使用打开的图窗口中的属性来确定代码生成的图形的外观。中的语法包含的数字不适用此首选项外部图形.
使用下面的代码作为模板来生成满足您需要的图窗口。
创建图形图1 =图(“名字”,“purple_background”,...“颜色”,[0.4784 0.06275 0.8941]);colormap (“hsv”);创建子图次要情节(1,1,1,“父”,图1);框(“上”);%创建轴标签包含(“轴”);ylabel ({“轴”})%创建标题标题({“标题”});
使打印输出与屏幕上的颜色匹配集(图1,“InvertHardcopy”,“关闭”)
通过在此窗口打开时发布文件,然后使用新数字选项设置为假
,任何代码生成的图形都采用打开的图窗口的属性。
请注意
您必须设置图捕获法选项entireFigureWindow为最终发布的图形显示打开的图形窗口的所有属性。
创建缩略图
您可以将第一个代码生成的图形保存为缩略图。您可以使用此缩略图在HTML页面上表示您的文件。要创建缩略图,请遵循以下步骤:
在发布选项卡上,单击发布并选择编辑发布选项.弹出“编辑配置”对话框。
设置图像格式位图格式的选项,例如
. png
或jpg
.MATLAB创建位图格式的缩略图图像。设置创建缩略图选项
真正的
.控件指定的文件夹中保存缩略图图像输出文件夹选项中的发布设置窗格。
保存发布设置
您可以保存发布设置,这使您可以轻松地重新生成输出。保存您常用的发布设置可能很有用。
当发布设置选项设置完成后,您可以按照以下步骤保存设置:
点击另存为当选项以你想要的方式设置时。
的另存发布设置为对话框将打开并显示当前定义的所有发布设置的名称。默认情况下,使用MATLAB安装以下发布设置:
出厂默认值
属性不能覆盖
出厂默认值
并可以通过选择恢复它们出厂默认值
从发布设置列表。用户默认
最初,
用户默认
的设置相同出厂默认值
设置。可以覆盖用户默认
设置。
在设置名称字段时,为设置输入有意义的名称。然后单击保存.
现在可以将发布设置与其他MATLAB文件一起使用。
还可以覆盖保存在现有名称下的发布属性。属性中的名称发布设置列表,然后单击覆盖.
管理发布配置
一起,代码在MATLAB的表情窗格中的“设置”发布设置窗格制作与一个文件关联的发布配置。这些配置提供了一种简单的方法来引用单个文件的发布首选项。
上创建发布配置发布选项卡上,单击发布,并选择编辑发布选项.Edit Configurations对话框将打开,其中包含默认的发布首选项。在发布配置名称字段,输入发布配置的名称,或接受默认名称。发布配置将自动保存。
运行现有的发布配置
保存发布配置后,可以在不打开“编辑配置”对话框的情况下运行它:
点击发布.如果将鼠标指针定位在发布配置名称上,MATLAB将显示一个工具提示,其中显示与特定配置关联的MATLAB表达式。
选择要用于发布配置的配置名称。MATLAB使用代码发布文件,并发布与配置相关的设置。
为文件创建多个发布配置
您可以为给定的文件创建多个发布配置。您可以使用不同的输入参数值发布文件,使用不同的发布设置属性值发布文件,或者两者兼而有之。为每个目的创建一个命名配置,所有配置都与同一个文件相关联。稍后,您可以运行所需的任何特定发布配置。
按照以下步骤创建新的发布配置。
在编辑器中打开文件。
单击发布按钮下拉箭头,并选择编辑发布选项.弹出“编辑配置”对话框。
单击添加按钮位于左侧窗格。
一个新的名称出现在配置列表中,
filename_n
的值n
取决于现有的配置名称。中的设置MATLAB的表情或发布设置窗格,MATLAB自动保存更改。
重新关联和重命名发布配置
每个发布配置都与一个特定的文件相关联。如果移动或重命名文件,请重新定义其关联。如果您删除了一个文件,请考虑删除相关的配置,或将它们与另一个文件关联。
当MATLAB无法将配置与文件关联时,“编辑配置”对话框将显示红色的文件名和文件未找到消息。执行以下步骤,将配置与其他文件重新关联。
单击清晰的搜索按钮在“编辑配置”对话框的左侧窗格中。
选择要为其重新关联发布配置的文件。
在“编辑配置”对话框的右侧窗格中,单击选择…….在“打开”对话框中,导航到并选择要与之重新关联配置的文件。
您可以在任何时候通过从左侧窗格的列表中选择配置来重命名配置。属性的值发布配置名称.
请注意
中的代码语句要在文件名更改后正确运行,可能需要更改MATLAB的表情窗格。例如,更改函数调用以反映该函数的新文件名。
使用跨不同系统发布配置
每次使用“编辑配置”对话框创建或保存发布配置时,编辑器都会更新publish_configurations.m
文件在您的首选项文件夹。(这是运行MATLAB时MATLAB返回的文件夹prefdir
函数。)
虽然您可以将该文件从一个系统上的首选项文件夹移植到另一个系统上,但只能移植一个系统publish_configurations.m
文件可以存在于系统中。因此,只有在第二个系统上没有创建任何发布配置时,才可以将文件移动到另一个系统。此外,因为publish_configurations.m
文件可能包含对文件路径的引用,请确保指定的文件和路径存在于第二个系统中。
MathWorks®建议您不要更新publish_configurations.m
在MATLAB编辑器或文本编辑器中。使用“编辑配置”对话框以外的工具所做的更改稍后可能会被覆盖。