Main Content

La traducción de esta página está obsoleta. Haga clic aquí para ver la última versión en inglés.

Publicar y compartir código de MATLAB

MATLAB® proporciona opciones para presentar su código a otros. Puede publicar sus archivos de código de MATLAB (.m) para crear documentos con formato o crear y compartir scripts y funciones en vivo en Live Editor.

Crear y compartir scripts en vivo en Live Editor

La manera más fácil de crear documentos cohesivos, que se puedan compartir y que incluyan código ejecutable de MATLAB, salida integrada y texto con formato es utilizar Live Editor. Los formatos de salida compatibles son: MLX, PDF, Microsoft® Word, HTML y LaTeX. Para obtener más detalles, consulte Crear scripts en vivo en Live Editor.

Publicar archivos de código de MATLAB (.m)

Para crear documentos que se puedan compartir usando sus archivos de código de MATLAB (.m), puede publicar los archivos. La publicación de un archivo de código de MATLAB crea un documento con formato que incluye el código, comentarios y la salida. Las razones habituales para publicar el código son compartir los documentos con otros para la enseñanza o la demostración, o generar una documentación legible y externa del código.

Este código demuestra la expansión en serie de Fourier para una onda cuadrada.

Código de MATLAB con marcado

Documento publicado

Para publicar el código:

  1. Cree un script o una función de MATLAB. Divida el código en pasos o secciones insertando dos signos de porcentaje (%%) al principio de cada sección.

  2. Documente el código agregando comentarios explicativos al principio del archivo y dentro de cada sección.

    En los comentarios de la parte superior de cada sección, puede agregar marcas que mejoren la legibilidad de la salida. Por ejemplo, el código de la tabla anterior incluye el siguiente marcado.

    Títulos

    %% Square Waves from Sine Waves

    %% Add an Odd Harmonic and Plot It

    %% Note About Gibbs Phenomenon

    Nombre de variable en cursiva

    % As _k_ increases, ...

    Ecuación LaTeX

    % $$ y = y + \frac{sin(k*t)}{k} $$

    Nota

    Cuando tiene un archivo que contiene texto con caracteres en una codificación diferente a la de su plataforma, al guardar o publicar el archivo, MATLAB muestra dichos caracteres como texto ilegible.

  3. Publique el código. En la pestaña Publish, haga clic en Publish.

    De forma predeterminada, MATLAB crea una subcarpeta llamada html, que contiene un archivo HTML y archivos para cada uno de los gráficos que crea el código. El archivo HTML incluye el código, comentarios con formato y la salida. También puede publicar en otros formatos, como archivos PDF o presentaciones de Microsoft PowerPoint®. Para obtener más información sobre la publicación en otros formatos, consulte Specify Output File.

    En MATLAB Online™, para permitir que MATLAB abra las ventanas de salida automáticamente cuando se publica, habilite las ventanas emergentes de su navegador web.

Después de publicar el código, puede compartir la carpeta que contiene los archivos publicados. Para obtener más información, consulte Share Folders in MATLAB. En MATLAB Online, también puede hacer que los resultados estén disponibles públicamente copiando los archivos publicados de la carpeta html en la carpeta Published. Después, puede utilizar una URL con el formato https://matlab.mathworks.com/users/userid/Published/filename/index.html (para HTML) o https://matlab.mathworks.com/users/userid/Published/foldername/filename.pdf (para PDF) para compartir los archivos.

El código de ejemplo que aparece en la figura anterior forma parte de la documentación instalada. Puede ver el código en el editor ejecutando este comando:

edit(fullfile(matlabroot,'help','techdoc','matlab_env', ...
             'examples','fourier_demo2.m'))

Agregar ayuda y crear documentación

Puede agregar ayuda al código insertando comentarios al principio del archivo de código de MATLAB. MATLAB muestra los comentarios de ayuda cuando se escribe help file_name en la ventana de comandos. Para obtener más información, consulte Add Help for Your Program.

También puede crear sus propios temas de documentación de MATLAB para verlos desde el navegador de ayuda o la web de MATLAB. Para obtener más información, consulte Display Custom Documentation

Consulte también

Temas relacionados

Sitios web externos