Thanks, Álvaro. Unfortunately, it seems the contributed matlab domain for Sphinx, while it works fine for functions, does not handle classdef properly<https://www.mathworks.com/matlabcentral/answers/1759470-how-can-i-generate-html-documentation-from-help-doc-output>.
I’m making a little progress using MATLAB’s undocumented help2html() function. I’m currently leaning towards using Sphinx for the higher level documentation and then linking to some reference HTML files generated by help2html(), where the documentation for each class, property and method is pulled directly from the help documentation in the source using MATLAB’s own tools. Ray On Jul 14, 2022, at 1:37 PM, Álvaro Jaramillo Duque <alvaro.jaramillo.du...@gmail.com<mailto:alvaro.jaramillo.du...@gmail.com>> wrote: Hi all I have no experience, but it seems that Sphinx can handle the documentatio. There are some examples: https://opencobra.github.io/cobratoolbox/stable/index.html https://cosmomvpa.org/index.html And the sphinx complement https://github.com/sphinx-contrib/matlabdomain I hope this helps and best regards Álvaro Jaramillo Duque On Tue, Jul 12, 2022 at 5:05 PM Ray Daniel Zimmerman <r...@cornell.edu<mailto:r...@cornell.edu>> wrote: Hi all, Sorry, things have been so quiet here on the developers list. I know I’m not nearly as good at communicating with all of you as I should be. I’ve been hard at work on MP-Element<https://github.com/MATPOWER/mp-element/>, which is turning out to be essentially a complete rewrite of MATPOWER to make it many times more flexible and powerful. More on that to come. However, the reason for this e-mail is to get suggestions and comments (and hopefully some help) regarding documentation infrastructure for upcoming versions of MATPOWER. I have a lot of new code that needs to be properly documented before it can be released. Many languages make it easy to pull documentation text directly from the code files to generate reference documentation. And there are tools that allow multiple formats (especially HTML and PDF) to be generated from a single set of source documents. In particular, Python’s documentation<https://docs.python.org/> is based on Sphinx<https://www.sphinx-doc.org/>, as are the many projects hosted by Read the Docs<https://readthedocs.org/>, and it turns out that Sphinx supports a contributed “domain” for handling Matlab documentation as well. The following are some of my goals for MATPOWER documentation going forward: * Keep all help text in the code compatible with MATLAB’s help and doc commands, and as close as possible to MathWorks conventions. * Use Sphinx to automatically generate reference documentation directly from the code and embedded help text. * Write all of the documentation in reStructuredText (reST) format, so Sphinx can be used to generate HTML and PDF versions of everything. The big questions are, does anyone here have … … experience with Sphinx (with Matlab code or otherwise)? … suggestions for an alternative? You feedback is greatly appreciated. Thanks, Ray
