Which tool are you using to create the documentation of your MATLAB codes?

156 次查看（过去 30 天）
Aurelien Queffurust
评论： Nathan Ellingson 2021-9-3
I would like to know which documentation system you use to create the developer's guide or your MATLAB codes.
I already found 2 FEx utilities on this subject:
makehtmldoc to create easily HTML help pages from MATLAB codes.
Using Doxygen with Matlab
I plan to try Doxygen which seems popular . Have you already tried it?
Do you know other tools which can extract comments from your codes to generate documentation?
Thanks for your feedback

请先登录，再回答此问题。

采纳的回答

per isakson
per isakson 2013-1-10
编辑：per isakson 2013-1-10
M2HTML: Documentation System for Matlab in HTML has been around and supported for a long time - long before the new OOP-system. It is definitely worth looking at.
The questions says that the documentation support of Matlab is not adequate for your needs.
  2 个评论
Aurelien Queffurust
Aurelien Queffurust 2013-1-22
I have tried files from Fex which use Doxygen but it requires a lot of stuff to install and some time to understand the mechanism. My favorite one will be M2HTML which is both easy and quick to run . The output is very nice if the source code has a M-file header . Nice features a with Graph, each HTML output file gives dependencies, parent functions ... Super! Thanks for your suggestion.

请先登录，再进行评论。

更多回答（4 个）

Mark Mikofski
Mark Mikofski 2017-12-13
Try Sphinx MATLAB domain, it's free and it automatically generates documents from your H1 comments if they are formatted using Sphinx markup. Disclaimer, I was the original author of the Sphinx MATLAB domain.
  2 个评论
Brian Holmes
Brian Holmes 2020-8-23
The Sphinx MATLAB seems to be a promising choice. But its documentation and help is very poor, making it effectively useless.
Nathan Ellingson
Nathan Ellingson 2021-9-3
After reweiwing all the tools under this question, I settled on this one. Sphinx Matlab is a plugin to Sphinx so some Sphinx knowledge is required to use it. I found that the Sphinx Matlab documentation was excellent, while the Sphinx proper documentation was kind of hard to folow. However, I think this is expected with a project as complex and powerful as Sphinx.
If you have time to work with sphinx to make some really excellent custom documentation, I recommend using the Matlab plugin for sphinx. If you need documentation right now and don't have time to mess with it I recommend m2html (I think the brain template looks the best).

请先登录，再进行评论。

Pierre Ollfisch
Pierre Ollfisch 2021-7-23
编辑：Pierre Ollfisch 2021-7-24
You could also try m2docgen. It generates HTML-websites based on your header comments and integrates them directly in the local MATLAB documentation. It works with '*.m' and '*.mlx' files of functions, classes and scripts. The sites can also be found by the search function, as the builddocsearchdb is also called in the process. I have attached an example of how the input and output looks for a class file.
Input:
Output:
Disclaimer: I am a developer of m2doc.
Ryan G
Ryan G 2013-1-10
MATLAB Report Generator has a lot of options for HTML reports. It's not free, but obviously it's designed well for the job.
  1 个评论
Jiri Vass
Jiri Vass 2018-5-10
Can you please provide more details about using the MATLAB Report Generator for automatically generating the documentation of my Matlab code? I used the M2HTML already and it generates useful Matlab code documentation (e.g. dependency diagram, HTML to browse my functions), but if the MATLAB Report Generator provides even better functionality, I'd like to know about it.

请先登录，再进行评论。

Sean de Wolski
Sean de Wolski 2013-1-10
Also, an (impossible to remember) function:
builddocsearchdb
  2 个评论
Aurelien Queffurust
Aurelien Queffurust 2013-1-10
I am using this function to make the help of functions of my own toolbox reachable from Help browser. It is the only aim of this feature I believe , it will not create HTML files from your code.

请先登录，再进行评论。

类别

在 Help Center 和 File Exchange 中查找有关 Environment and Settings 的更多信息

标签

产品

Community Treasure Hunt

Find the treasures in MATLAB Central and discover how the community can help you!

Start Hunting!

Translated by