MATLAB M文件帮助格式
 

我找不到可以用来为自己的MATLAB函数编写帮助的格式。 [URL="http://www.mathworks.com/help/techdoc/matlab_prog/f7-41453.html#f7-38710"]官方文档中[/URL]几乎没有信息。

您是否知道“帮助浏览器”（不是“帮助”功能）可以显示的任何其他格式？因为它是内置函数。如何格式化标题（如语法，说明，示例）？子弹，桌子可以吗？ [B]还是应该是一个单独的文件？[/B]

我曾尝试将文本标记用于发布和HTML，但没有用。

我发现只有一件有趣的事情。如果您的函数包含大小写混合，例如testHelpFunction ，则其名称将突出显示：

[IMG]https://i.stack.imgur.com/8FPYq.png[/IMG]

如果只是testhelpfunction突出显示。

还有其他想法吗？

[B]更新[/B]

这是我找到的有关创建自己的帮助文件的详尽文档：

[URL="https://web.archive.org/web/20101031000134/http://www.mathworks.com/help/techdoc/matlab_env/bruby4n-1.html"]提供您自己的帮助和演示[/URL]
（死链接替换为Web存档链接）

（无效链接已删除）

[B]再次更新：[/B]
[LIST][*] [URL="http://www.mathworks.com/help/matlab/matlab_prog/add-help-for-your-program.html"]为您的程序添加帮助[/URL][*] [URL="http://www.mathworks.com/help/matlab/matlab_prog/display-custom-documentation.html"]显示自定义文档[/URL][/LIST]
[B]回答：[/B]

请尝试官方文档中的另一部分。更彻底。 MATLAB>用户指南>桌面工具和开发环境>定制帮助和演示>提供您自己的帮助和演示。本文介绍了简单的帮助文本和生成单独的HTML帮助文件。

这是我选择并发现有用的帮助文本格式。

function foo(x,y,z) %FOO One-line description goes here % % foo(x,y,z) % % Multi-line paragraphs of descriptive text go here. It's fine for them to % span lines. It's treated as preformatted text; help() and doc() will not % re-wrap lines. In the editor, you can highlight paragraphs, right-click, % and choose "Wrap selected comments" to re-flow the text. % % More detailed help is in the [URL="matlab: help foo>extended_help"]extended help[/URL]. % It's broken out like this so you can keep the main "help foo" text on % a single screen, and then break out obscure parts to separate sections. % % Examples: % foo(1,2,3) % % See also: % BAR % SOMECLASS/SOMEMETHOD disp(x+y+z); function extended_help %EXTENDED_HELP Some additional technical details and examples % % Here is where you would put additional examples, technical discussions, % documentation on obscure features and options, and so on. error('This is a placeholder function just for helptext'); [LIST][*]功能签名之后的第一行称为“ H1行”。它仅需一行，因此可以由contentsrpt（）适当地拾取，后者可以从函数中的帮助文本自动生成Contents.m文件[*] H1行中的函数名称全为大写，无论签名中函数名称的实际大小写如何[*]案例对于“另请参见”很重要。我不确定哪种情况都能奏效；这是肯定的。[*] “另请参阅：”之后的功能名称全为大写。方法名称是合格的；我认为与当前方法位于同一类中的方法名称可能不合格。[/LIST]H1行和“示例：”之间的所有内容都是我认为可读的常规格式； help（）不会对其进行特殊处理。

您可以在帮助中使用有限形式的超链接。特别是，您可以使用超链接来调用任意的Matlab命令，并通过使它调用help（）来指向帮助文本的其他部分。您可以使用它来指向任何功能。 “功能>子功能”只是用于在help（）调用中寻址子功能的语法。不幸的是，由于您需要在这些超链接中放入“帮助”或“ doc”，因此它只能以一种或另一种形式使用。如果有直接的帮助文本超链接形式，那就更好了。



[url=https://stackoverflow.com/questions/3840657]更多&回答...[/url]