发布和共享 MATLAB 代码

目录

发布和共享 MATLAB 代码

在实时编辑器中创建和共享实时脚本

发布 MATLAB 代码

添加帮助和创建文档

---

发布和共享 MATLAB 代码

        MATLAB® 提供多种向其他人展示代码的选项，包括使用发布功能，以及在实时编辑器中创建实时脚本和函数。

在实时编辑器中创建和共享实时脚本

​        要创建包含可执行 MATLAB 代码、嵌入式输出和格式化文本的可共享综合文档，最简单的方法是使用实时编辑器。支持的输出格式包括：MLX、PDF、Microsoft® Word、HTML 和 LaTeX。具体可以参考在实时编辑器中创建实时脚本。

发布 MATLAB 代码

        发布 MATLAB 代码文件 (.m) 可创建包括您的代码、注释和输出的格式化文档。发布代码的常见原因是与其他人共享文档以用于教学或演示，或者生成代码的可读外部文档。

        此代码演示了方波的傅里叶级数展开式。

包含标记的 MATLAB 代码	发布的文档

要发布的代码，请执行以下操作：

1.创建一个 MATLAB 脚本或函数。通过在每个部分的开头插入两个百分比符号 (%%) 来将代码划分为多个步骤或节。

        通过在文件开头及每节中添加说明性注释来记录代码。在各节顶部的注释中，可以添加标记来增强输出的可读性。例如，上表中的代码包括以下标记。

标题	%% Square Waves from Sine Waves %% Add an Odd Harmonic and Plot It %% Note About Gibbs Phenomenon
斜体格式的变量名称	% As _k_ increases, ...
LaTeX 方程	% $$ y = y + \frac{sin(k*t)}{k} $$

注意：如果文件中的文本所包含的字符编码与平台编码不同，那么在保存或发布文件时，MATLAB 会将这些字符显示为乱码。

2.发布代码。在发布选项卡上，点击发布。

​        默认情况下，MATLAB 为代码创建的每个图形创建一个名为 html 的子文件夹，其中包含一个或多个 HTML 文件。HTML 文件包括代码、格式化注释和输出。也可以发布为其他格式，例如 PDF 文件或 Microsoft PowerPoint® 演示文稿。

        在 MATLAB Online 中，MATLAB 发布为 HTML 或 PDF 格式，并将输出和支持文件存储在您的 Published 文件夹中。要允许 MATLAB 自动打开输出，请在 Web 浏览器中启用弹出窗口。结果可以使用 https://matlab.mathworks.com/users/userid/Published/filename/index.html 形式的 URL 公开访问。

        显示在前面的图窗中的示例代码是已安装文档的一部分。可以通过运行此命令在编辑器中查看该代码：

edit(fullfile(matlabroot,'help','techdoc','matlab_env', ...
             'examples','fourier_demo2.m'))

添加帮助和创建文档

​        可以通过在 MATLAB 代码文件的开头插入注释来为代码添加帮助。当在命令行窗口中键入 help file_name 时，MATLAB 会显示帮助注释。具体可以参考为程序添加帮助。

        也可以创建自己的 MATLAB 文档主题，以便从 MATLAB 帮助浏览器或 Web 查看。具体可以参考显示自定义文档。

​