主要内容

发布

生成视图MATLAB指定格式的文件

折叠所有页面

语法

发布(文件)
发布(文件格式)
发布(文件、名称、值)
发布(文件,选项)
My_doc = publish(文件，___）

描述

例子

发布(文件）生成指定MATLAB的视图®代码文件和输出的HTML格式，可用于共享。发布将HTML文件和代码创建的每个图形的文件保存在名为超文本标记语言．的位置超文本标记语言子文件夹相对于的位置文件．

例如,发布(C: \ myMATLABfiles \ myfile.m)运行代码myfile.m使用基本工作区，然后保存格式化的代码和结果C: \ myMATLABfiles \ \ myfile.html html．

例子

发布(文件，格式）以指定的文件格式生成指定MATLAB文件的视图。所有文件格式保存到超文本标记语言子文件夹。

例子

发布(文件，名称,值）生成指定MATLAB文件的视图，其中包含一个或多个指定的选项名称,值对参数。

例子

发布(文件，选项）使用选项结构生成指定的MATLAB文件的视图。当您希望预配置并保存选项以供重复使用时，使用结构来指定选项非常有用。属性的字段和值选项结构对应于名-值对参数的名称和值。

例子

My_doc = publish(文件，___）生成指定MATLAB文件的视图，并返回结果输出文件的路径。您可以将此语法与前面语法中的任何输入参数组合一起使用。

例子

全部折叠

生成MATLAB脚本的HTML视图，包括代码、结果和注释。

复制示例文件fourier_demo2.m到当前文件夹。

文件名= fullfile(matlabroot，“帮助”，“techdoc”，“matlab_env”，“例子”，“fourier_demo2.m”）;拷贝文件(文件名,“。”，“f”）

使用发布函数来运行示例并生成示例的HTML视图。然后，使用网络函数查看生成的文件。

发布(“fourier_demo2.m”）;网络(“html / fourier_demo2.html”）

生成一个微软®词一个MATLAB脚本的视图，包括代码、结果和注释。

复制示例文件fourier_demo2.m到当前文件夹。

文件名= fullfile(matlabroot，“帮助”，“techdoc”，“matlab_env”，“例子”，“fourier_demo2.m”）;拷贝文件(文件名,“。”，“f”）

使用发布函数生成微软文字处理软件示例的视图。然后，使用winopen函数查看生成的文件。

发布(“fourier_demo2.m”，“医生”）;winopen (“html / fourier_demo2.doc”）

使用名称-值对参数可更改MATLAB脚本HTML视图中已发布的图形窗口的外观。

复制示例文件fourier_demo2.m到当前文件夹。

文件名= fullfile(matlabroot，“帮助”，“techdoc”，“matlab_env”，“例子”，“fourier_demo2.m”）;拷贝文件(文件名,“。”，“f”）

使用发布函数生成示例的HTML视图。使用“figureSnapMethod”名称-值对参数“entireFigureWindow”要包括窗口装饰，并将人物背景颜色与人物的屏幕颜色相匹配。然后，使用网络函数查看生成的文件。

发布(“fourier_demo2.m”，“figureSnapMethod”，“entireFigureWindow”)网络(“html / fourier_demo2.html”）

使用结构来创建微软文字处理软件不显示脚本代码的MATLAB脚本视图。当您希望预配置并保存选项以供重复使用时，将选项指定为结构非常有用。

复制示例文件fourier_demo2.m到当前文件夹。

文件名= fullfile(matlabroot，“帮助”，“techdoc”，“matlab_env”，“例子”，“fourier_demo2.m”）;拷贝文件(文件名,“。”，“f”）

创建一个结构选项它指定了格式而且showcode选项。

选项。格式=“医生”；选项。showCode = false;

使用发布函数生成微软文字处理软件中指定的选项的示例视图选项．然后，使用winopen函数查看生成的文件。

发布(“fourier_demo2.m”、选择);winopen (“html / fourier_demo2.doc”）

生成需要输入参数的MATLAB函数的HTML视图。

创建并保存函数fact.m．

计算一个数字的阶乘% FACT(N)计算数字N的阶乘并返回结果函数F =事实(n) F = prod(1:n);结束

使用发布函数生成函数的HTML视图。设置输入参数的值n通过使用“codeToEvaluate”名称-值对参数。然后，使用网络函数查看生成的文件。

发布(“fact.m”，“codeToEvaluate”，”事实(5),“)网络(“html / fact.html”）

生成MATLAB脚本的HTML视图，并将发布的HTML文件的路径保存到一个变量。

复制示例文件fourier_demo2.m到当前文件夹。

文件名= fullfile(matlabroot，“帮助”，“techdoc”，“matlab_env”，“例子”，“fourier_demo2.m”）;拷贝文件(文件名,“。”，“f”）

使用发布函数生成示例的HTML视图，并将已发布的HTML文件的路径保存到该变量mydoc．

Mydoc = publish(“fourier_demo2.m”）
mydoc = C:\myMATLABfiles\html\fourier_demo2.html

输入参数

全部折叠

MATLAB文件名，指定为字符向量或字符串。文件可以包含完整路径或部分路径。

请注意

当MATLAB发布一个文件时，它可以覆盖输出文件夹中以相同名称开头的现有文件文件．

例子:发布(“myfile.m”)

例子:发布(C: \ myMATLABfiles \ myfile.m)

已发布文件的输出格式，指定为表中列出的值之一。

价值 输出格式
“html”(默认) 超文本标记语言
“医生” 微软文字处理软件
“乳胶” 乳胶
ppt的 微软演示文稿®
“xml” 可扩展标记语言
“pdf” 便携式文件格式(PDF)

的微软文字处理软件而且微软演示文稿格式仅在Windows上可用®平台。

当您指定输出格式为时，MATLAB不会保留语法高亮显示微软演示文稿或乳胶。

例子:发布(‘myfile.m’,‘ppt);

已发布输出的选项，以结构形式指定。使用选项结构，而不是名值对参数，当您想重用相同的配置发布多个MATLAB文件。

属性的字段和值选项结构对应于名称-值对参数的名称和值。

例如，该命令创建结构选项，并指定PDF输出格式和输出文件夹C: \ myPublishedOutput．

选项= struct(“格式”，“pdf”，“outputDir”，“C: \ myPublishedOutput”）

名称-值参数

指定可选参数对为Name1 = Value1,…,以=家,在那里的名字参数名称和价值对应的值。名称-值参数必须出现在其他参数之后，但对的顺序无关紧要。

在R2021a之前，使用逗号分隔每个名称和值，并将其括起来的名字在报价。

例子:“格式”、“pdf”,“showCode”,假的指定PDF输出文件格式，并从输出中排除代码。

输出选项

全部折叠

已发布文件的输出格式，指定为表中列出的值之一。

价值 输出格式
“html”(默认) 超文本标记语言(HTML)
“医生” 微软文字处理软件
“乳胶” 乳胶
ppt的 微软演示文稿
“xml” 可扩展标记语言
“pdf” 便携式文件格式(PDF)

的微软文字处理软件而且微软演示文稿格式仅在Windows平台上可用。

当您指定输出格式为时，MATLAB不会保留语法高亮显示微软演示文稿或乳胶。

例子:发布(‘myfile.m’,‘格式’,pdf)

将发布的文档保存到其中的输出文件夹，指定为字符向量。指定文件夹的完整路径。

例子:发布(“myfile.m”、“outputDir”、“C: \ myPublishedOutput”)

可扩展样式表语言(XSL)文件，在将MATLAB文件发布为指定为字符向量的HTML、XML或LaTeX格式时使用。指定XSL文件的完整路径。

例子:发布(“myfile.m”、“样式表”,“C: \ myStylesheet \ stylesheet.xsl”)

图选项

全部折叠

是否为已发布的文档创建缩略图，指定为真正的或假．您可以使用生成的缩略图在HTML页面上显示文件的一个小表示。

图已发布文档的窗口外观，指定为表中列出的值之一。图窗口外观包括绘图的背景颜色，以及它是否包括窗口装饰(标题栏、工具栏、菜单栏和窗口边框)。

中不可用此选项MATLAB在线™．

价值 窗口装饰 背景颜色
gui 数据 gui 数据

“entireGUIWindow”(默认)

包括

被排除在外

匹配屏幕

白色

“打印”

被排除在外

被排除在外

白色

白色

“getframe”

被排除在外

被排除在外

匹配屏幕

匹配屏幕

“entireFigureWindow”

包括

包括

匹配屏幕

匹配屏幕

图像文件格式，用于发布文档中的图像，指定为表中列出的值之一。有效图像格式的列表取决于指定的输出格式。

输出格式 有效的图像格式 默认图像格式
微软文字处理软件

安装版本的任何图像格式微软办公软件可以导入，包括“png”，“jpg”，bmp的,“饮”．如果“figureSnapMethod”选项设置为“打印”，那么你也可以指定“每股收益”，“epsc”，“eps2”，“生病”，“元”,“pdf”．

 “png”
超文本标记语言(HTML)

所有图像格式。

确保用于查看和处理输出文件的工具能够显示指定的输出格式。

 “png”
乳胶

所有图像格式。

确保用于查看和处理输出文件的工具能够显示指定的输出格式。

“epsc2”

默认更改为“png”在这些情况下:

  • figureSnapMethod是“getframe”．

  • figureSnapMethod是“entireFigureWindow”．

  • figureSnapMethod是“entireGUIWindow”断开的窗口是一个GUI窗口。
便携式文件格式(PDF)

bmp的而且“jpg”．

 bmp的
微软演示文稿

您安装的任何版本的格式微软办公软件可以导入，包括“png”，“jpg”，bmp的,“饮”．

 “png”
可扩展标记语言(XML)

所有图像格式。

确保用于查看和处理输出文件的工具能够显示指定的图像格式。

 “png”

已发布图像的最大图像高度，指定为以下值之一:

  • ［］(默认)-高度无限制。当输出格式为PDF时，始终使用此值。

  • 正整数-高度(像素)。

已发布图像的最大图像宽度，指定为以下值之一:

  • ［］(默认)-宽度无限制。当输出格式为PDF时，始终使用此值。

  • 正整数-以像素为单位的宽度。

是否创建新图形，指定为真正的或假．如果真正的代码生成一个图形，然后MATLAB在发布前创建一个默认大小的白色背景的新图形窗口。如果假， MATLAB不创建图形窗口。

指定值为假如果要使用具有不同属性的图形进行发布，则很有用。例如，您可以打开一个图形窗口，更改大小和背景颜色，然后发布代码。已发布文档中的图形使用发布前打开的图形的特征。

代码的选择

全部折叠

是否运行代码并在已发布的视图中包含MATLAB输出，指定为真正的或假．

是否在发布期间捕获错误，指定为真正的或假．如果真正的出现错误时，MATLAB继续发布，并将错误包含在发布的文件中。如果假发生错误时，MATLAB在命令行显示错误，而不生成发布文件。

在发布期间运行的附加代码，指定为字符向量。使用此选项可运行MATLAB文件中未包含的代码。例如，在发布函数时，可以设置输入参数的值。

如果未指定此选项，MATLAB只运行要发布的MATLAB文件中的代码。

例子:发布(‘myfunction.m’,‘codeToEvaluate’,‘myfunction (10) ')

所发布文档中包含的最大输出行数，指定为以下值之一:

  • 正(默认值)- MATLAB包含了发布文档中的所有输出。

  • 非负整数- MATLAB只包含已发布文档中指定的行数。如果输出的样本较小且具有代表性，则设置此选项非常有用。

是否在发布的文件中包含代码，指定为真正的或假．

如果输出格式是HTML, MATLAB会在发布的HTML文件的末尾包含代码作为注释，即使您设置了“showCode”选项假．将代码作为注释包含可以启用grabcode函数从HTML文件中提取MATLAB代码，即使该文件不显示代码。代码不会显示在Web浏览器中，因为MATLAB将代码包含为注释。

提示

  • 若要增强已发布文档的可读性并包括其他图像快照、外部文件内容和外部图像，请参见出版的标记．

  • 的发布函数在生成活动脚本或活动函数的视图时不包括格式化文本(.mlx)．要生成整个活动脚本或活动函数的视图，请使用出口函数来代替。

  • 在发布MATLAB代码文件时，为避免重复快照，请确保在调用发布函数。将光标放在图形上可能会导致图形更新发布命令用于生成重复的快照。

版本历史

R2006a之前介绍

另请参阅

||||

主题