MATLAB：强制 doc 命令打开指定的参考 HTML 页面

假设我在包中编写了一个类，名为mypackage.myclass。我已经为包和类编写了自己的 HTML 文档，并将其包含在 MATLAB 帮助浏览器中，如下所述MATLAB 文档.

我可以通过使用帮助浏览器直接导航到该 HTML 文档来显示该文档，但是输入doc mypackage.myclass不显示它；相反，它显示一些由以下命令自动生成的 HTML 文档helpwin（这是一个很好的功能，但不是我想要的 - 自动生成的文档对我的用户来说太技术性了）。

我怎样才能强迫doc显示我的文档，而不是自动生成的文档？

等效地：

当你跑步时doc docTopic，在doc命令中的Java类com.mathworks.mlservices.MLHelpServices.showReferencePage(docTopic)被叫。如果参考页面为docTopic存在，它显示它并返回成功值。如果参考页面不存在，它将返回一个失败值，这会导致helpwin(docTopic)被叫。某个地方一定有一些连接值的目录docTopic带有单独的参考 HTML 文件。我如何修改该目录 - 或者我可以为我的包创建一个目录吗？

MathWorkers 和 @Yair，请给我足够的无证绳子来上吊:)

据我所知，这是不可能的，也不是 MathWorks 的意图。我也不知道有什么未记录的方法可以做到这一点。据我记得的关键词doc被硬编码在某处。

根据您的设置，您可以尝试以下操作： 准备您自己的doc使用的命令web(..., '-helpbrowser')在 MATLAB 的帮助浏览器中显示 HTML 页面：

function doc(topic)

    my_topics = {
        'foo', 'foo.html'
        'bar', 'bar/help/intro.html'
    };

    for i = 1 : size(my_topics, 1)
        if strcmpi(topic, my_topics{i, 1})      
            web(my_topics{i, 2}, '-helpbrowser');
            return;
        end
    end

    % Fall back to MATLAB's doc. Note that our doc shadows MATLAB's doc.
    docs = which('doc', '-all');
    old_dir = cd();
    c = onCleanup(@() cd(old_dir));
    cd(fileparts(docs{2}));
    doc(topic); 
end

如果你将该函数放在一个文件中doc.m并将相应的目录放在 MATLAB 路径的开头（请参见help addpath）然后它将被调用而不是内置的doc.

当然，您可以使用其他位置来存储自定义文档映射（例如文件）或使用某种动态查找方案。

UPDATE:从 MATLAB R2012b 开始，'-helpbrowser'的选项web是无证的。这可能与该 MATLAB 版本中的 GUI 更改有关，其中还包括帮助浏览器。web(..., '-helpbrowser')仍按预期工作，但在 MATLAB 的未来版本中可能会发生变化。据我所知，没有记录的打开方式anyR2012b 中帮助浏览器中的 HTML 页面。