¿Cuál es la forma en que Mathworks genera documentación HTML de Matlab?

Resuelto Lukas asked hace 10 años • 3 respuestas

Estoy trabajando en código Matlab compartido y nos gustaría compartir una documentación generada como documentos HTML con capacidad de búsqueda dentro de nuestra red local.

Conozco los siguientes métodos para generar una documentación:

  1. Escriba un convertidor a archivos tipo C++. Esto se hace en Uso de Doxygen con Matlab (última actualización en 2011) y mtoc++ (última actualización en 2013). Luego, Doxygen analiza los archivos tipo C++.
  2. Utilice el dominio sphinxcontrib-matlab de Python para generar una documentación HTML.
  3. Utilice m2html , que también es una solución de terceros.
  4. En estas preguntas y respuestas se enumeran más opciones: Uno , Dos y Tres .

Mathworks no admite todas las posibilidades. Todas las posibilidades necesitan que yo mencione, es decir, los parámetros de una función. No analizan el código en el sentido, Doxygen lo hace, es decir, para Java:

//! an object representation of the advertisement package sent by the beacon
private AdvertisementPackage advertisementPackage;

Escuché sobre la función publicar() de Matlab , pero nunca la vi utilizada en el sentido antes mencionado.

Pregunta: ¿Cuál es la forma en que Mathworks genera documentación HTML de Matlab? ¿Se puede analizar el código en sí? ¿Puedo utilizar ya la información proporcionada al analizador de entrada de Matlab? Por favor mencione su preferencia personal en los comentarios.

Ejemplo:

%% Input parser
p = inputParser;
addRequired(p, 'x', @isnumeric);

validationFcn = @(x) (isnumeric(x) && isscalar(x));
addRequired(p, 'fftSize', validationFcn);
addRequired(p, 'fftShift', validationFcn);

validationFcn = @(x) (isa(x, 'function_handle'));
addRequired(p, 'analysisWindowHandle', validationFcn);

parse(p, x, fftSize, fftShift, analysisWindowHandle);
Lukas avatar Oct 08 '14 00:10 Lukas
Aceptado

Creo que esta es la forma oficialmente aprobada de Mathworks de escribir documentación: http://www.mathworks.co.uk/help/matlab/matlab_prog/display-custom-documentation.html

Básicamente, escriba el HTML y agregue un montón de archivos para que se pueda buscar y mostrar en la documentación de MATLAB.

am304 avatar Oct 07 '2014 19:10 am304

Existe una manera fácil de usar publicar con una función y sus entradas correspondientes. mira a publish('test',struct('codeToEvaluate','test(inputs);','showCode',false, )).

user5161122 avatar Jul 27 '2015 14:07 user5161122