Выходные настройки для публикации

Как Редактирование опций печати

Используйте настройки публикации значения по умолчанию, если ваш код не требует никаких входных параметров, и вы хотите опубликовать к HTML. Однако, если ваш код требует входных параметров, или если вы хотите задать выходные настройки, выполнение кода или форматы фигуры, затем задайте пользовательскую конфигурацию.

  1. Найдите вкладку Publish и кликните по стрелке кнопки Publish.

  2. Выберите Edit Publishing Options.

    Диалоговое окно Edit Configurations открывается. Задайте выходные настройки.

Панель выражения MATLAB задает код, который выполняется во время публикации. Панель настроек Publish содержит вывод, фигуру и опции выполнения кода. Вместе, они делают то, к чему относится MATLAB® как опубликовать настройка. MATLAB сопоставляет, каждый публикует настройку с файлом .m. Имя опубликовать настройки появляется в левой верхней панели.

Определение выходного файла

Вы задаете выходной формат и местоположение на панели настроек Publish.

MATLAB публикует к этим форматам.

ФорматПримечания
htmlПубликует к документу HTML. Можно использовать Расширяемый язык таблиц стилей (XSL) файл.
xmlПубликует к XML-документу. Можно использовать Расширяемый язык таблиц стилей (XSL) файл.
latexПубликует, чтобы ПРОПИТАТЬ ЛАТЕКСОМ документ. Не сохраняет подсветку синтаксиса. Можно использовать Расширяемый язык таблиц стилей (XSL) файл.
документПубликует к документу Word Microsoft®. Не сохраняет подсветку синтаксиса. Этот формат только доступен на платформах Windows®.
pptПубликует к документу Microsoft PowerPoint®. Не сохраняет подсветку синтаксиса. Этот формат только доступен на платформах Windows.
pdf Публикует к документу в формате PDF.

Примечание

Файлы XSL позволяют вам больше управления внешним видом выходного документа. Для получения дополнительной информации см. http://docbook.sourceforge.net/release/xsl/current/doc/.

Выполнение кода во время публикации

Определение кода

По умолчанию MATLAB выполняет файл .m, который вы публикуете. Однако можно задать любой допустимый код MATLAB в панели выражения MATLAB. Например, если вы хотите опубликовать функцию, которая требует входного параметра, затем запустите команду function(input). Дополнительный код, чей выводит вас, хочет опубликовать, появляется после вызова функций. Если вы очищаете область выражения MATLAB, то MATLAB публикует файл, не оценивая кода.

Примечание

Опубликуйте использование настроек основной MATLAB workspace. Поэтому переменная в панели выражения MATLAB перезаписывает значение для существующей переменной в базовом рабочем пространстве.

Оценка кода

Другой способ влиять, что MATLAB выполняет во время публикации, состоит в том, чтобы установить Оценивать опцию кода в панели установки Publish. Эта опция указывает, оценивает ли MATLAB код в файле .m, который публикует. Если установлено в true, MATLAB выполняет код и включает результаты в выходной документ.

Поскольку MATLAB не оценивает код, ни включает результаты кода, когда вы устанавливаете Оценивать опцию кода на false, в файле может быть недопустимый код. Поэтому рассмотрите сначала петляние с этим набором опции к true.

Например, предположите, что вы включаете текст комментария, Label the plot, в файле, но забываете снабжать его предисловием с символом комментария. Если вы публикуете документ HTML и устанавливаете Оценивать опцию кода на true, вывод включает ошибку.

Используйте опцию false, чтобы опубликовать файл, который содержит функцию publish. В противном случае MATLAB пытается опубликовать файл рекурсивно.

Включая код

Можно задать, отобразить ли код MATLAB в окончательном результате. Если вы устанавливаете Включать опцию кода на true, то MATLAB включает код в опубликованный выходной документ. Если установлено в false, MATLAB исключает код из всех форматов выходного файла, кроме HTML.

Если формат выходного файла является HTML, MATLAB вводит код как комментарий HTML, который не видим в веб-браузере. Если вы хотите извлечь код из файла вывода HTML, используйте функцию grabcode MATLAB.

Например, предположите, что вы публикуете H:/my_matlabfiles/my_mfiles/sine_wave.m к HTML с помощью опубликовать настройки с Включать набором опции кода к false. Если вы совместно используете вывод с коллегами, они могут просмотреть его в веб-браузере. Чтобы видеть код MATLAB, который сгенерировал вывод, они могут дать следующую команду от папки, содержащей sine_wave.html:

grabcode('sine_wave.html')
MATLAB открывает файл, который создал sine_wave.html в Редакторе.

Фиксация ошибок

Можно отловить и опубликовать любые ошибки, которые происходят во время публикации. Установка ошибочной опции Выгоды к true включает любые сообщения об ошибке в выходной документ. Если вы устанавливаете, Фиксируют ошибку к false, MATLAB отключает опубликовать операцию, если ошибка происходит во время оценки кода. Однако эта опция не имеет никакого эффекта, если вы устанавливаете Оценивать свойство кода на false.

Ограничение объема Вывода

Можно ограничить количество строк кода вывод, который включен в выходной документ путем определения Max # выходной опции строк в панели настроек Publish. Устанавливание этой опции полезно, если меньшая, репрезентативная проба кода вывод достаточна.

Например, следующий цикл генерирует 100 строк в опубликованном выводе, если Max # выходных строк не установлен в нижнее значение.

for n = 1:100
  disp(x)	
end;

Управление графикой в публикации Вывод

Выбор формата изображения

При публикации можно выбрать формат изображения, который использование MATLAB, чтобы сохранить любую графику сгенерировало во время выполнения кода. Доступные форматы изображения в выпадающем списке зависят от установки опции метода получения фигуры. Для самой большой совместимости выберите значение по умолчанию, как задано в этой таблице.

Формат выходного файлаФормат изображения по умолчаниюТипы изображений можно включать
документpng

Любой формат, что ваша установленная версия поддержек Microsoft Office.

htmlpng

Все форматы публикуют успешно. Гарантируйте, чтобы инструменты вы использовали для представления и обработали выходные файлы, может отобразить выходной формат, который вы задаете.

latexpng или epsc2

Все форматы публикуют успешно. Гарантируйте, чтобы инструменты вы использовали для представления и обработали выходные файлы, может отобразить выходной формат, который вы задаете.

pdfbMP

bmp и jpg.

pptpng

Любой формат, что ваша установленная версия поддержек Microsoft Office.

xmlpng

Все форматы публикуют успешно. Гарантируйте, чтобы инструменты вы использовали для представления и обработали выходные файлы, может отобразить выходной формат, который вы задаете.

Установка размера изображения

Вы устанавливаете размер сгенерированных изображений MATLAB в панели настроек Publish на диалоговом окне Edit Configurations. Вы задаете размер изображения в пикселях, чтобы ограничить ширину и высоту изображений в выводе. Пиксельные значения действуют как максимальное значение размера, потому что MATLAB поддерживает соотношение сторон изображения. MATLAB игнорирует установку размера для следующих случаев:

  • При работе с внешней графикой, как описано во Внешней Графике

  • При использовании векторных форматов, таких как .eps

  • При публикации к .pdf

Получение фигур

Можно получить различные аспекты Окна фигуры путем установки опции метода получения фигуры. Эта опция определяет художественные оформления окна (строка заголовка, панель инструментов, панель меню и граница окна) и фоны графика для Окна фигуры.

Эта таблица суммирует эффекты различных методов получения фигуры.

Используйте этот метод получения фигурыПолучить фигуру получения с этими деталями внешнего вида
 Художественные оформления окнаФоны графика

entireGUIWindow

Включенный для диалоговых окон; Исключенный для фигурУстановите на белый для фигур; совпадает с экраном для диалоговых окон

печать

Исключенный для диалоговых окон и фигурУстановите на белый

getframe

Исключенный для диалоговых окон и фигурСовпадает с экранным фоном графика

entireFigureWindow

Включенный для диалоговых окон и фигурСовпадает с экранным фоном графика

Примечание

Как правило, фигуры MATLAB имеют набор свойств HandleVisibility к on. Диалоговые окна являются фигурами с набором свойств HandleVisibility к off или callback. Если ваши результаты отличаются от результатов, перечисленных в предыдущей таблице, свойство HandleVisibility ваших фигур или диалоговых окон может быть нетипичным. Для получения дополнительной информации смотрите HandleVisibility.

Определение пользовательского Окна фигуры

MATLAB позволяет вам задавать пользовательский внешний вид для фигур, которые это создает. Если Использование, новая опция фигуры в панели настроек Publish установлена в true, то в опубликованном выводе, MATLAB использует Окно фигуры в размере по умолчанию и с белым фоном. Если Использование, новая опция фигуры установлена в false, то MATLAB использует свойства из создать Окна фигуры, чтобы определить внешний вид сгенерированных кодом фигур. Эта настройка не применяется к включенному использованию фигур синтаксиса во Внешней Графике.

Используйте следующий код в качестве шаблона, чтобы произвести Окна фигуры, которые удовлетворяют ваши потребности.

% Create figure
figure1 = figure('Name','purple_background',...
'Color',[0.4784 0.06275 0.8941]);
colormap('hsv'); 

% Create subplot
subplot(1,1,1,'Parent',figure1); 
box('on');

% Create axis labels
xlabel('x-axis');
ylabel({'y-axis'})

% Create title
title({'Title'});

% Enable printed output to match colors on screen
set(figure1,'InvertHardcopy','off')

Путем публикации файла с этим открытым окном и Использование новый набор опции фигуры к false, любая сгенерированная кодом фигура берет свойства создать Окна фигуры.

Примечание

Необходимо установить опцию метода получения фигуры на entireFigureWindow для опубликованной фигуры финала отображать все свойства создать Окна фигуры.

Создание миниатюры

Можно сохранить первую сгенерированную кодом диаграмму как изображение миниатюр. Можно использовать эту миниатюру, чтобы представлять файл на страницах HTML. Чтобы создать миниатюру, выполните эти шаги:

  1. На вкладке Publish нажмите кнопку Publish выпадающая стрелка и выберите Edit Publishing Options. Диалоговое окно Edit Configurations открывается.

  2. Установите опцию Формата изображения на растровый формат, такой как .png или .jpg. MATLAB создает изображения миниатюр в растровых форматах.

  3. Установите Создать опцию миниатюры на true.

    MATLAB сохраняет в папке изображение миниатюр, заданное опцией папки Output в панели настроек Publish.

Сохранение опубликовать настройки

Можно сохранить ваш публиковать настройки, который позволяет вам воспроизводить вывод легко. Может быть полезно сохранить ваш обычно используемый, публикуют настройки.

Когда опции настроек Publish установлены, можно выполнить эти шаги, чтобы сохранить настройки:

  1. Нажмите Save As, когда опции установлены таким образом, вы хотите.

    Диалоговое окно Save Publish Settings As открывает и отображается, имена весь в настоящее время задаваемый публикуют настройки. По умолчанию следующее публикует установку настроек с MATLAB:

    • Factory Default

      Вы не можете перезаписать Factory Default и можете восстановить их путем выбора Factory Default из списка настроек Publish.

    • User Default

      Первоначально, настройки User Default идентичны настройкам Factory Default. Можно перезаписать настройки User Default.

  2. В Поле имени Настроек введите понятное имя для настроек. Затем нажмите Save.

    Можно теперь использовать опубликовать настройки с другими файлами MATLAB.

    Также можно перезаписать свойства публикации, сохраненные под существующим именем. Выберите имя из списка настроек Publish, и затем нажмите Overwrite.

Управление опубликовать настройки

Вместе, код в панели выражения MATLAB и настройки в панели настроек Publish делают опубликовать настройку, которая сопоставлена с одним файлом. Эти настройки обеспечивают простой способ относиться, чтобы опубликовать настройки для отдельных файлов.

Чтобы создать опубликовать настройку, нажмите кнопку Publish выпадающая стрелка на вкладке Publish и выберите Edit Publishing Options. Диалоговое окно Edit Configurations открывается, содержание значения по умолчанию публикует настройки. В Опубликовать поле имени настройки введите имя для опубликовать настройки или примите имя по умолчанию. Опубликовать настройка сохраняет автоматически.

Выполнение существующего публикует настройку

После сохранения опубликовать настройки можно запустить его, не открывая диалоговое окно Edit Configurations:

  1. Нажмите кнопку Publish выпадающая стрелка, Если вы располагаете свой указатель мыши на опубликовать имя настройки, MATLAB отображает подсказку, показывающую выражение MATLAB, сопоставленное с определенной настройкой.

  2. Выберите имя настройки, чтобы использовать для опубликовать настройки. MATLAB публикует файл с помощью кода, и опубликуйте настройки, сопоставленные с настройкой.

Создание нескольких публикует настройки для файла

Можно создать, несколько публикуют настройки для данного файла. Вы можете сделать, это, чтобы опубликовать файл с различными значениями для входных параметров, с различным публикует значения свойств установки или обоих. Создайте именованную настройку для каждой цели, все сопоставленные с тем же файлом. Позже можно запуститься, какой бы ни конкретный публикуют настройку, которую вы хотите.

Используйте следующие шаги в качестве руководства, чтобы создать новый, публикуют настройки.

  1. Откройте файл в своем Редакторе.

  2. Нажмите кнопку Publish выпадающая стрелка и выберите Edit Publishing Options. Диалоговое окно Edit Configurations открывается.

  3. Нажмите кнопку Add, расположенную на левой панели.

    Новое имя появляется в списке настроек, filename_n, где значение n зависит от существующих имен настройки.

  4. Если вы изменяете настройки в выражении MATLAB или панели установки Publish, MATLAB автоматически сохраняет изменения.

Пересоединение и переименование публикуют настройки

Каждый публикует настройку, сопоставлен с определенным файлом. Если вы перемещаете или переименовываете файл, переопределяете его ассоциацию. Если вы удаляете файл, рассматриваете удаление связанных настроек или соединение их с различным файлом.

Когда MATLAB не может сопоставить настройку с файлом, диалоговое окно Edit Configurations отображается имя файла красного и Файла Не Найденное сообщение. Чтобы повторно сопоставить настройку с другим файлом, выполните следующие шаги.

  1. Кликните по Ясной кнопке поиска на левой панели диалогового окна Edit Configurations.

  2. Выберите файл, для которого вы хотите повторно сопоставить, публикуют настройки.

  3. На правой панели диалогового окна Edit Configurations нажмите Choose.... В диалоговом окне Open перейдите к и выберите файл, с которым вы хотите повторно сопоставить настройки.

Можно переименовать настройки в любое время путем выбора настройки из списка на левой панели. На правой панели отредактируйте значение для Опубликовать имени настройки.

Примечание

Чтобы запуститься правильно после изменения имени файла, вы можете должны быть изменить операторы кода в панели выражения MATLAB. Например, измените вызов функции отразить новое имя файла для этой функции.

Используя публикуют настройки через различные системы

Каждый раз, когда вы создаете или сохраняете опубликовать настройку с помощью диалогового окна Edit Configurations, Редактор обновляет файл publish_configurations.m в папке настроек. (Это - папка, которую возвращает MATLAB, когда вы запускаете функцию prefdir MATLAB.)

Несмотря на то, что можно портировать этот файл от папки настроек в одной системе другому, только один файл publish_configurations.m может существовать в системе. Поэтому только переместите файл в другую систему, если вы не создали, любой публикует настройки во второй системе. Кроме того, потому что файл publish_configurations.m может содержать ссылки на пути к файлам, быть уверенным, что заданные файлы и пути существуют во второй системе.

MathWorks® рекомендует, чтобы вы не обновили publish_configurations.m в редакторе MATLAB или текстовом редакторе. Изменения, что вы делаете инструменты использования кроме диалогового окна Edit Configurations, могут быть перезаписаны позже.

Похожие темы

Была ли эта тема полезной?