MATLAB® предоставляет возможности для представления вашего кода другим, включая использование публикации и создание live скриптов и функций в Live Editor.
Самый легкий способ создать связные, документы с обеспечением совместного доступа, которые включают исполняемый код MATLAB, встроенный выход и форматированный текст, состоит в том, чтобы использовать Live Editor. Поддерживаемые выходные форматы включают: MLX, PDF, Microsoft® Word, HTML и LaTeX. Для получения дополнительной информации смотрите, Создают Live скрипты в Live Editor.
Publishing файл кода MATLAB (.m
) создает отформатированный документ, который включает ваш код, комментарии и выход. Общие причины опубликовать код состоят в том, чтобы совместно использовать документы с другими для обучения или демонстрации, или сгенерировать читаемую, внешнюю документацию вашего кода.
Этот код демонстрирует последовательное расширение Фурье для прямоугольной волны.
Код MATLAB с разметкой | Опубликованный документ |
---|---|
|
|
Опубликовать ваш код:
Создайте скрипт MATLAB или функцию. Разделите код на шаги или разделы путем вставки двух знаков процента (%%
) в начале каждого раздела.
Зарегистрируйте код путем добавления пояснительных текстов в начале файла и в каждом разделе.
В рамках комментариев во главе каждого раздела можно добавить разметку, которая улучшает удобочитаемость выхода. Например, код в предыдущей таблице включает следующую разметку.
Заголовки |
|
Имя переменной курсивом |
|
Уравнение LaTeX |
|
Примечание
Когда у вас есть файл, содержащий текст, который имеет символы в кодировке, отличной от вашей платформы, когда вы сохраняете или публикуете свой файл, MATLAB отображает те символы как искаженный текст.
Опубликуйте код. На вкладке Publish нажмите Publish.
По умолчанию MATLAB создает подпапку под названием html
, который содержит файл HTML и файлы для каждой диаграммы, которую создает ваш код. Файл HTML включает код, отформатированные комментарии и выход. В качестве альтернативы можно опубликовать к другим форматам, таким как файлы PDF или представления Microsoft PowerPoint®. Для получения дополнительной информации о публикации к другим форматам смотрите, Задают Выходной файл.
В MATLAB Online™ MATLAB публикует или в HTML или в PDF, и хранит выходные и вспомогательные файлы в вашем Published
папка. Чтобы позволить MATLAB открывать выход автоматически, включите всплывающие окна в своем веб-браузере. Результаты доступны публично использование URL формы https://matlab.mathworks.com/users/
(для HTML) или userid
/Published/filename
/index.htmlhttps://matlab.mathworks.com/users/
(для PDF).userid
/Published/foldername
FileName
.pdf
Пример кода, который появляется на предыдущем рисунке, является частью установленной документации. Можно просмотреть код в Редакторе путем выполнения этой команды:
edit(fullfile(matlabroot,'help','techdoc','matlab_env', ... 'examples','fourier_demo2.m'))
Можно добавить справку к коду путем вставки комментариев в начале файла кода MATLAB. MATLAB отображает комментарии справки, когда вы вводите help
file_name
в Командном окне. Для получения дополнительной информации смотрите, Добавляет Справка для Вашей Программы.
Также можно создать собственные темы документации MATLAB для просмотра от Браузера документации MATLAB или сети. Для получения дополнительной информации см. Отображение пользовательской документации