publish
以指定格式生成 MATLAB 文件的视图
语法
说明
publish(
生成指定 MATLAB® 代码文件的视图并将其输出为可以共享的 HTML 格式的文件。file
)publish
在名为 html
的子文件夹中保存该 HTML 文件和代码创建的所有图形文件。html
子文件夹的位置相对于 file
的位置。
例如,publish('C:\myMATLABfiles\myfile.m')
使用基础工作区运行 myfile.m
中的代码,然后将格式化的代码和结果保存在 C:\myMATLABfiles\html\myfile.html
中。
publish(
通过一个或多个 file
,Name,Value
)name,value
对组参数指定的选项生成指定 MATLAB 文件的视图。
示例
生成 MATLAB 脚本的 HTML 视图
生成 MATLAB 脚本的 HTML 视图,包括代码、结果和注释。
将示例文件 fourier_demo2.m
复制到您的当前文件夹。
filename = fullfile(matlabroot,'help','techdoc','matlab_env','examples','fourier_demo2.m'); copyfile(filename,'.','f')
使用 publish
函数运行该示例并生成示例的 HTML 视图。然后,使用 web
函数查看生成的文件。
publish('fourier_demo2.m'); web('html/fourier_demo2.html')
以 Microsoft Word 格式生成 MATLAB 脚本的视图
生成 MATLAB 脚本的 Microsoft® Word 视图,包括代码、结果和注释。
将示例文件 fourier_demo2.m
复制到您的当前文件夹。
filename = fullfile(matlabroot,'help','techdoc','matlab_env','examples','fourier_demo2.m'); copyfile(filename,'.','f')
使用 publish
函数生成示例的 Microsoft Word 视图。然后,使用 winopen
函数查看生成的文件。
publish('fourier_demo2.m','doc'); winopen('html/fourier_demo2.doc')
使用名称-值对组自定义 MATLAB 脚本的视图
使用名称-值对组参数更改 MATLAB 脚本的 HTML 视图中已发布图窗窗口的外观。
将示例文件 fourier_demo2.m
复制到您的当前文件夹。
filename = fullfile(matlabroot,'help','techdoc','matlab_env','examples','fourier_demo2.m'); copyfile(filename,'.','f')
使用 publish
函数生成示例的 HTML 视图。使用值为 'entireFigureWindow'
的 'figureSnapMethod'
名称-值对组参数以包含窗口装饰,并使图窗背景色与图窗的屏幕颜色相匹配。然后,使用 web
函数查看生成的文件。
publish('fourier_demo2.m','figureSnapMethod','entireFigureWindow') web('html/fourier_demo2.html')
使用结构体自定义 MATLAB 脚本的视图
使用结构体创建 MATLAB 脚本的 Microsoft Word 视图,其中不显示脚本中的代码。当您希望预配置并保存选项以便重复使用时,将 options 指定为结构体很有用。
将示例文件 fourier_demo2.m
复制到您的当前文件夹。
filename = fullfile(matlabroot,'help','techdoc','matlab_env','examples','fourier_demo2.m'); copyfile(filename,'.','f')
创建结构体 options
,该结构体指定 format
和 showcode
选项。
options.format = 'doc';
options.showCode = false;
使用 publish
函数和在 options
中指定的选项生成示例的 Microsoft Word 视图。然后,使用 winopen
函数查看生成的文件。
publish('fourier_demo2.m',options); winopen('html/fourier_demo2.doc')
生成带输入参数的 MATLAB 函数的 HTML 视图
生成需要输入参数的 MATLAB 函数的 HTML 视图。
创建并保存函数 fact.m
。
%% FACT compute the factorial of a number % FACT(N) computes the factorial of the number N and returns the results function f = fact(n) f = prod(1:n); end
使用 publish
函数生成函数的 HTML 视图。使用 'codeToEvaluate'
名称-值对组参数设置输入参数 n
的值。然后,使用 web
函数查看生成的文件。
publish('fact.m','codeToEvaluate','fact(5);') web('html/fact.html')
将已发布脚本的文件路径保存为变量
生成 MATLAB 脚本的 HTML 视图,并将已发布的 HTML 文件的路径保存为变量。
将示例文件 fourier_demo2.m
复制到您的当前文件夹。
filename = fullfile(matlabroot,'help','techdoc','matlab_env','examples','fourier_demo2.m'); copyfile(filename,'.','f')
使用 publish
函数生成示例的 HTML 视图,并将已发布的 HTML 文件的路径保存到变量 mydoc
。
mydoc = publish('fourier_demo2.m')
mydoc = C:\myMATLABfiles\html\fourier_demo2.html
输入参数
file
— MATLAB 文件名
字符向量 | 字符串
MATLAB 文件名,指定为字符向量或字符串。file
可以包括完整路径或部分路径。
注意
当 MATLAB 发布文件时,它可覆盖输出文件夹中与 file
同名的现有文件。
示例: publish('myfile.m')
示例: publish('C:\myMATLABfiles\myfile.m')
format
— 输出格式
'html'
(默认) | 'doc'
| 'latex'
| 'ppt'
| 'xml'
| 'pdf'
已发布文件的输出格式,指定为下表中列出的值之一。
值 | 输出格式 |
---|---|
'html' (默认值) | 超文本标记语言 |
'doc' | Microsoft Word |
'latex' | LaTeX |
'ppt' | Microsoft PowerPoint® |
'xml' | 可扩展标记语言 |
'pdf' | 可移植文档格式 (PDF) |
Microsoft Word 和 Microsoft PowerPoint 格式仅在 Windows® 平台上可用。
将输出格式指定为 Microsoft PowerPoint 或 LaTeX 时,MATLAB 不会保留语法高亮。
示例: publish('myfile.m','ppt');
options
— 已发布输出的选项
结构体
已发布输出的选项,指定为结构体。要重复使用相同配置来发布多个 MATLAB 文件时,请使用 options
结构体代替名称-值对组参数。
options
结构体的字段和值与名称-值对组参数的名称和值对应。
例如,以下命令创建结构体 options
,并指定 PDF 输出格式和输出文件夹 C:\myPublishedOutput
。
options = struct('format','pdf','outputDir','C:\myPublishedOutput')
名称-值参数
将可选的参数对组指定为 Name1=Value1,...,NameN=ValueN
,其中 Name
是参数名称,Value
是对应的值。名称-值参数必须出现在其他参数之后,但参数对组的顺序无关紧要。
在 R2021a 之前,使用逗号分隔每个名称和值,并用引号将 Name
引起来。
示例: 'format','pdf','showCode',false
指定 PDF 输出文件格式并从输出中排除代码。
format
— 输出格式
'html'
(默认) | 'doc'
| 'latex'
| 'ppt'
| 'xml'
| 'pdf'
已发布文件的输出格式,指定为下表中列出的值之一。
值 | 输出格式 |
---|---|
'html' (默认值) | 超文本标记语言 (HTML) |
'doc' | Microsoft Word |
'latex' | LaTeX |
'ppt' | Microsoft PowerPoint |
'xml' | 可扩展标记语言 |
'pdf' | 可移植文档格式 (PDF) |
Microsoft Word 和 Microsoft PowerPoint 格式仅在 Windows 平台上可用。
将输出格式指定为 Microsoft PowerPoint 或 LaTeX 时,MATLAB 不会保留语法高亮。
示例: publish('myfile.m','format','pdf')
outputDir
— 输出文件夹
字符向量
用于保存已发布文档的输出文件夹,指定为字符向量。指定文件夹的完整路径。
示例: publish('myfile.m','outputDir','C:\myPublishedOutput')
stylesheet
— 可扩展样式表语言 (XSL) 文件
字符向量
将 MATLAB 文件发布为 HTML、XML 或 LaTeX 格式时使用的可扩展样式表语言 (XSL) 文件,指定为字符向量。指定 XSL 文件的完整路径。
示例: publish('myfile.m','stylesheet','C:\myStylesheet\stylesheet.xsl')
createThumbnail
— 是否创建缩略图图像
true
(默认) | false
是否为已发布文档创建缩略图图像,指定为 true
或 false
。您可以使用生成的缩略图在 HTML 页面上显示文件的缩略表示形式。
figureSnapMethod
— 图窗窗口外观
'entireGUIWindow'
(默认) | 'print'
| 'getframe'
| 'entireFigureWindow'
已发布文档的图窗窗口外观,指定为下表中列出的值之一。图窗窗口外观包括绘图的背景色以及它是否包含窗口装饰(标题栏、工具栏、菜单栏和窗口边框)。
此选项在 MATLAB Online™ 中不可用。
值 | 窗口装饰 | 背景色 | ||
---|---|---|---|---|
GUI | 图窗 | GUI | 图窗 | |
| 已包含 | 不包含 | 与屏幕匹配 | 白色 |
| 不包含 | 不包含 | 白色 | 白色 |
| 不包含 | 不包含 | 与屏幕匹配 | 与屏幕匹配 |
| 已包含 | 已包含 | 与屏幕匹配 | 与屏幕匹配 |
imageFormat
— 图像文件格式
'png'
| 'epsc2'
| 'jpg'
| ...
已发布文档中图像的图像文件格式,指定为下表中列出的值之一。有效图像格式的列表取决于指定的输出格式。
输出格式 | 有效图像格式 | 默认图像格式 |
---|---|---|
Microsoft Word | 可以导入已安装 Microsoft Office 版本的任何图片格式,包含 | 'png' |
超文本标记语言 (HTML) | 所有图像格式。 确保您用于查看和处理输出文件的工具可以显示指定的输出格式。 | 'png' |
LaTeX | 所有图像格式。 确保您用于查看和处理输出文件的工具可以显示指定的输出格式。 |
在下列情况下,默认值更改为
|
可移植文档格式 (PDF) |
| 'bmp' |
Microsoft PowerPoint | 可以导入已安装 Microsoft Office 版本的任何格式,包含 | 'png' |
可扩展标记语言 (XML) | 所有图像格式。 确保您用于查看和处理输出文件的工具可以显示指定的图像格式。 | 'png' |
maxHeight
— 最大图像高度
[]
(默认) | 正整数
已发布图像的最大图像高度,指定为下列值之一:
[]
(默认值)- 高度不受限制。当输出格式为 PDF 时,始终使用此值。正整数 - 以像素为单位的高度。
maxWidth
— 最大图像宽度
[]
(默认) | 正整数
已发布图像的最大图像宽度,指定为下列值之一:
[]
(默认值)- 宽度不受限制。当输出格式为 PDF 时,始终使用此值。正整数 - 以像素为单位的宽度。
useNewFigure
— 是否创建新图窗
true
(默认) | false
是否创建新图窗,指定为 true
或 false
。如果为 true
并且代码生成了图窗,则 MATLAB 会在发布前以默认大小创建一个具有白色背景的新图窗窗口。如果为 false
,则 MATLAB 不创建图窗窗口。
如果要对发布的图窗应用不同的属性,则指定值 false
非常有用。例如,您可以打开一个图窗窗口,更改大小和背景色,然后发布您的代码。已发布文档中的图窗将使用您发布之前打开的图窗的特征。
evalCode
— 是否运行代码
true
(默认) | false
是否运行代码并在发布视图中包含 MATLAB 输出,指定为 true
或 false
。
catchError
— 是否捕获错误
true
(默认) | false
是否在发布期间捕获错误,指定为 true
或 false
。如果为 true
并且发生了错误,则 MATLAB 继续发布并将错误包含在发布文件中。如果为 false
并且发生了错误,则 MATLAB 在命令行中显示错误,并且不生成发布文件。
codeToEvaluate
— 要运行的其他代码
字符向量
要在发布期间运行的其他代码,指定为字符向量。使用此选项可运行未包含在 MATLAB 文件中的代码。例如,发布函数时,可以设置输入参数的值。
如果未指定该选项,则 MATLAB 仅运行您正在发布的 MATLAB 文件中的代码。
示例: publish('myfunction.m','codeToEvaluate','myfunction(1,10)')
maxOutputLines
— 最大行数
Inf
(默认) | 非负整数值
要包含在已发布文档中的最大输出行数,指定为下列值之一:
Inf
(默认值)- MATLAB 在已发布文档中包含所有输出。非负整数 - MATLAB 在已发布文档中仅包含指定的行数。如果一个较小的代表性输出示例就能满足需求,则设置此选项很有用。
showCode
— 是否包含代码
true
(默认) | false
是否在已发布文件中包含代码,指定为 true
或 false
。
如果输出格式为 HTML,MATLAB 将在已发布 HTML 文件的末尾处以注释的形式附上代码,即使您将 'showCode'
选项设置为 false
也是如此。将代码作为注释包含使 grabcode
函数可以从 HTML 文件中提取 MATLAB 代码,即使文件不显示该代码也是如此。由于 MATLAB 将代码作为注释包含,因此该代码不会显示在 Web 浏览器中。
提示
版本历史记录
在 R2006a 之前推出
MATLAB 命令
您点击的链接对应于以下 MATLAB 命令:
请在 MATLAB 命令行窗口中直接输入以执行命令。Web 浏览器不支持 MATLAB 命令。
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)