主要内容

出版的标记

发布MATLAB时®代码文件(．m)，您可以通过在文件的注释中添加标记来增强已发布文档的可读性。添加标记允许您格式化发布的文档并显示外部文件和图形。

标记的概述

要插入标记，你可以:

  • 控件上的格式化按钮和下拉菜单发布选项卡格式化文件。此方法自动为您插入文本标记。

  • 从插入文本标记列表在右键菜单中。

  • 直接在注释中输入标记。

下表提供了文本标记选项的摘要。如果您不使用MATLAB编辑器，或不希望使用发布选项卡应用标记。

请注意

使用标记时:

  • 注释符号后面的空格(％)通常决定接下来的文章的格式。

  • 开始新的标记通常需要前面的空白注释行，如示例所示。

  • 标记只能在分段之后的注释中工作。

导致输出 对应文件标记的示例
章节及章节标题 
% %节标题%的描述性文字
%%%不带分段符的节标题%描述性文本
文本格式 
% _ITALIC TEXT_
% *粗体文本*
% | | MONOSPACED文本
%商标:% TEXT(TM)
%的文本(右)
项目符号和编号列表 
%%项目列表%% *项目列表1% % *项目列表2%
%%编号列表%% #编号项目1 % #编号项目2 %
文本和代码块 
%% %%预格式化%文本%
%% MATLAB(R) Code %% for i = 1:10 % disp x % end %
外部文件的内容 
% % > <包括文件名。m < /包括> %
外部图形 
% % << filename.png >> % . png
映像快照 
snapnow;
乳胶方程 
%% Inline表达式% x^2+e^{\ i}$
%% $e^{\ i} + 1 = 0$$ %
超链接 
MathWorks % < //www.tianjin-qmedu.com >
% < matlab:函数DISPLAYED_TEXT >
HTML标记 
% % < html > % <表边界= 1 > < tr > % < td > < / td > % < td >两个< / td > < / tr > < /表> % < / html > %
乳胶标记 
%% LaTeX Markup Example % < LaTeX > % \begin{tabular}{|r|r|} % \hline $n$&$n!$ % \线1 & 1 \ \ 2 \ \ 2 \ \ 3 6 \ \ % \线% \结束{表格}% < /乳胶> %

章节及章节标题

代码段允许您组织、添加注释和执行部分代码。代码段以双百分号开始(％%)，后跟一个可选的章节标题。节标题显示为顶级标题(h1在HTML中)，使用更大的粗体字体。

请注意

您可以在紧跟着标题的行中添加注释。但是，如果您想要一个完整的文档标题，则不能在下一节(以％%)．

例如，这段代码在发布时生成一个经过优化的结果。

您可以在向量上执行许多二进制操作。%% a = 1:3;B = 4:6;两个向量的点积是一个标量。% MATLAB有一个简单的点积命令。s manbetx 845s =点(A, B);两个向量的向量积得到第三个垂直于两个原始向量的向量。%再次，MATLAB有一个简单的命令，叉乘。s manbetx 845v =交叉(A, B);

将代码保存在编辑器中并单击发布按钮发布标签，MATLAB产生如图所示的输出。请注意，MATLAB会自动从MATLAB文件的节标题中插入Contents菜单。

文本格式

可以在MATLAB注释中标记选定的文本，以便在发布文件时以斜体、粗体或等宽文本显示。简单地围绕文本＿，＊,或|分别用于斜体、粗体或等宽文本。

例如，如果发布，这些行将显示每个文本格式语法。

计算和绘制正弦波% _define |x|的*range*

商标符号

如果MATLAB文件中的注释包含商标术语，则可以在输出中包含文本以产生商标符号(™)或注册商标符号(®)。简单的添加(右)或(TM)在所讨论的术语后面，中间没有任何空格。

例如，假设您在一个文件中输入了这些行。

这是MATLAB(R) %和符号数学工具箱(TM)的一些方面的演示。

如果您将文件发布到HTML，它就会出现在MATLAB web浏览器中。

项目符号和编号列表

MATLAB允许在注释中使用项目符号和编号列表。您可以使用此语法生成项目符号和编号列表。

%% Two Lists %% * ITEM1 % * ITEM2 %% # ITEM1 % # ITEM2 %

发布示例代码将产生以下输出。

文本和代码块

预格式化的文本

预格式化文本以单空格字体显示，保留空白，不换行。注释符号和预格式化文本的第一行的文本之间必须出现两个空格。

发布此代码将生成一个预格式化的段落。

许多人发现等宽文本更容易阅读:两个向量的点积得到一个标量。% MATLAB有一个简单的点积命令。s manbetx 845

语法突出显示示例代码

可执行代码出现在已发布的文档中，语法高亮显示。你也可以突出显示示例代码．示例代码是出现在注释中的代码。

要指示示例代码，您必须在注释符号和第一行代码的开头之间放置三个空格。例如，单击代码按钮发布选项卡在编辑器中插入以下示例代码。

%% %% for I = 1:10 % disp(x) % end %

将此代码发布到HTML会在MATLAB web浏览器中产生输出。

外部文件的内容

要将外部文件内容添加到MATLAB发布的代码中，请使用<包括>标记。指定相对于发布文件位置的外部文件路径。包括MATLAB代码文件发布的语法高亮代码。任何其他文件都以纯文本形式发布。

例如，这段代码插入sine_wave.m在您的出版输出:

%%外部文件内容示例%这个例子包含了sine_wave的文件内容。米到出版%输出。％% <包括> sine_wave.m < /包括>％%上面的文件内容是正确的语法突出显示

将文件发布到HTML。

外部图形

若要发布MATLAB代码不生成的图像，请使用文本标记。默认情况下，MATLAB已经包含了代码生成的图形。

这段代码插入一个称为FILENAME.PNG输入您已发表的输出。

%% %% << filename.png >> %

MATLAB要求FILENAME.PNG从输出位置到外部图像或完全限定URL的相对路径。好的做法是将您的图像保存在MATLAB发布输出的同一个文件夹中。例如，MATLAB将HTML文档发布到子文件夹中超文本标记语言．将图像文件保存在相同的子文件夹中。您可以通过更改发布配置设置来更改输出文件夹。在MATLAB在线™，保存您的图像文件到发表文件夹，该文件夹位于根文件夹中。

外部图形示例使用冲浪(峰值)

这个例子展示了如何插入surfpeaks.jpg转换成MATLAB文件进行发布。

创建surfpeaks.jpg，在命令窗口中运行此代码。

saveas(冲浪(峰值),“surfpeaks.jpg”);

生成包含surfpeaks.jpg从MATLAB文件:

  1. 创建一个名为超文本标记语言在当前文件夹中。

  2. 创建surfpeaks.jpg通过在命令窗口中运行此代码。

    saveas(冲浪(峰值)、html / surfpeaks.jpg);

  3. 将此MATLAB代码发布到HTML。

    %%图片示例%这是一个图形:%% <> %

输出文件格式的有效图像类型

发布时可以包含的图像类型取决于该文档的输出类型，如表中所示。为了获得最大的兼容性，最佳实践是为每个输出类型使用默认的图像格式。

输出文件格式 默认的图像格式 你可以包含的图像类型
医生 png

您所安装的版本的任何格式微软®办公室万博1manbetx支持。
超文本标记语言 png

所有格式发布成功。确保用于查看和处理输出文件的工具可以显示指定的输出格式。
乳胶 png或epsc2

所有格式发布成功。确保用于查看和处理输出文件的工具可以显示指定的输出格式。
pdf 骨形态发生蛋白

骨形态发生蛋白和jpg．
ppt png

您所安装的版本的任何格式微软办公软件万博1manbetx支持。
xml png

所有格式发布成功。确保用于查看和处理输出文件的工具可以显示指定的输出格式。

映像快照

您可以插入捕获MATLAB输出快照的代码。这是有用的，例如，如果你有为在每次迭代后修改想要捕获的图形的循环。

下面的代码运行为循环三次，每次迭代后产生输出。的snapnow命令捕获代码生成的所有三个图像。

%%缩放magic Data and Display as Image for i=1:3 imagesc(magic(i)) snapnow;结束

如果将文件发布到HTML，则输出如下所示。默认情况下，HTML中的图像比图中显示的要大。要调整由MATLAB代码生成的图像大小，请使用最大图像宽度和最大图像高度字段发布设置窗格，如发布的输出首选项．

乳胶方程

内联乳胶表达式

MATLAB使您能够在打算发布的任何代码中包含内联LaTeX表达式。要插入内联表达式，请用美元符号字符(＄)．的＄必须紧靠内联表达式的第一个单词之前，并紧靠内联表达式的最后一个单词之后，中间没有任何空格。

请注意

  • 除了Microsoft PowerPoint，所有发布输万博1manbetx出类型都支持LaTeX表达式®．

  • MATLAB发布支持标准LaTeX数万博1manbetx学模式指令。不支持文本模式指令或需要附加包的指令。万博1manbetx

这段代码包含一个LaTeX表达式:

这是一个等式:$x^2+e^{\pi i}$。它与文本是%内联的。

如果将示例文本标记发布到HTML，这就是结果输出。

乳胶显示方程

MATLAB使您能够在与主注释文本偏移的块中插入LaTeX符号。两个美元符号字符(＄$)表示一个块LaTeX方程。在单独的块中发布方程需要在块之间有一个空行。

这段代码是一个示例文本标记。

这是一个等式:%% $e^{\pi i} + 1 = 0$$ %%它与文本不一致。

如果将其发布到HTML，则表达式将显示如下所示。

超链接

静态链接

您可以在MATLAB注释中插入静态超链接，然后将文件发布到HTML、XML或微软文字处理软件．当指定到一个网站位置的静态超链接时，在代码中包含一个完整的URL。当你想给读者指出一个网站位置时，这是很有用的。您可以在发布的文本中显示或隐藏URL。当您确信读者正在浏览您的在线输出并可以单击超链接时，请考虑排除URL。

将url和任何替换文本用尖括号括起来。

有关更多信息，请参阅我们的网站:%

将代码发布到HTML将产生以下输出。

消除文本MathWorks在URL生成修改后的输出之后。

请注意

如果您的代码在MATLAB命令窗口中生成超链接文本，输出将显示HTML代码而不是超链接。

动态超链接

您可以插入动态超链接，当阅读器单击该链接时，MATLAB会对其进行计算。动态超链接使您能够将阅读器指向MATLAB代码或文档，或使阅读器能够运行代码。您可以使用matlab:语法。如果后面的代码matlab:声明中有空格，请将其替换为% 20．

请注意

动态链接仅在MATLAB web浏览器中查看HTML时有效。

动态链接的不同用途包括:

动态链接到运行代码。您可以指定一个动态超链接，以便在用户单击该超链接时运行代码。例如,这个matlab:语法在输出中创建超链接，当单击启用或禁用回收:

%%  %%

发布的结果类似于这个HTML输出。

当你点击其中一个超链接时，MATLAB设置回收相应的命令。点击超链接后，运行回收，以确认设置是否如您所期望的那样。

动态链接到文件。属性中指定指向文件的链接matlabroot你的读者。您不需要知道每个阅读器安装MATLAB的位置。例如，链接到的函数代码发布．

%% %查看%  %获取publish函数。

接下来，将文件发布到HTML中。

当你点击代码链接时，MATLAB编辑器将打开并显示用于发布函数。在阅读器的系统上，MATLAB发出命令(尽管命令不出现在阅读器的命令窗口中)。

动态链接到MATLAB函数引用页面。您可以指定一个链接到MATLAB函数参考页使用matlab:语法。例如，假设您的阅读器已经安装并运行了MATLAB。的链接发布参考页面。

请参阅函数的帮助。

将文件发布到HTML。

当你点击发布超链接时，MATLAB帮助浏览器打开并显示参考页面发布函数。在阅读器的系统上，MATLAB发出命令，尽管命令并不出现在命令窗口中。

HTML标记

您可以在MATLAB文件中插入HTML标记。您必须输入HTML标记，因为没有按钮发布标签生成它。

请注意

当您为HTML代码插入文本标记时，HTML代码只在指定的输出文件格式为HTML时发布。

该代码包括HTML标记。

% % % HTML标记示例,这是一个表:% % < HTML > % <表边界= 1 > < tr > < td >一个< / td > < td >两个< / td > < / tr > % < tr > < td > 3 < / td > < td >四< / td > < / tr > < /表> % < / HTML > %

如果将代码发布到HTML, MATLAB将创建一个带有两列的单行表。该表包含这些值一个，两个，三个,四个．

如果某个节生成以< html >和结尾< / html >， MATLAB在发布的输出中包含源HTML。例如，MATLAB显示disp命令，并从HTML代码创建一个表，如果你发布以下代码:

disp (' < html > <表> < tr > < td > 1 < / td > < td > 2 < / td > < / tr > < /表> < / html >”）

乳胶标记

可以将LaTeX标记插入到MATLAB文件中。必须键入所有LaTeX标记，因为没有按钮发布标签生成它。

请注意

当您为LaTeX代码插入文本标记时，该代码只在指定的输出文件格式为LaTeX时发布。

这段代码是LaTeX标记的一个例子。

%% LaTeX Markup Example %这是一个表:%% < LaTeX > % \begin{tabular}{|c|c|} \hline % $n$ & $n!美元\ \ \线% 1 & 1 \ \ % 2 & 2 \ \ % 3 & 6 \ \ \线% \结束{表格}% > < /橡胶

如果您将文件发布到LaTeX，那么编辑器将打开一个新的.tex包含LaTeX标记的文件。

这个LaTeX是由MATLAB代码自动生成的。%要进行更改，请更新MATLAB代码并重新发布此文档。这是一个表:\end{par} \vspace{1em} \begin{par} \begin{tabular}{|c|c|} \hline $n$ & $n!$ hline 1 & 1 \\ 2 & 2 \\ 3 & 6 \\ \hline \end{tabular} \end{par} \vspace{1em} \end{document}

MATLAB包括任何额外的标记，必须用LaTeX程序编译这个文件。

相关的话题

MATLAB的文档

万博1manbetx

介绍基于MATLAB的深度学习

介绍基于MATLAB的深度学习

下载电子书