Exponenta Banner
exponenta event banner

Отображение пользовательских примеров

Как отобразить примеры

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

  1. Создайте свои файлы в качестве примера. Храните файлы в папке, которая находится на пути поиска файлов MATLAB, но вне папки matlabroot.

    Совет

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

  2. Создайте файл demos.xml, который описывает имя, введите, и информация об отображении для ваших примеров.

    Например, предположите, что у вас есть тулбокс под названием My Sample, который содержит скрипт под названием my_example, который вы опубликовали в HTML. Этот файл demos.xml позволяет вам отображать my_example:

    <?xml version="1.0" encoding="utf-8"?>
<demos>
    <name>My Sample</name>
    <type>toolbox</type>
    <icon>HelpIcon.DEMOS</icon>
    <description>This text appears on the main page for your examples.</description>
    <website><a href="https://www.mathworks.com">Link to your Web site</a></website>

    <demosection>
        <label>First Section</label>
        <demoitem>
            <label>My Example Title</label>
            <type>M-file</type>
            <source>my_example</source>
        </demoitem>
    </demosection>

</demos>

    Примечание

    Элементы <demosection> являются дополнительными.

  3. Просмотрите свои примеры.

    1. В Браузере документации перейдите к домашней странице.

    2. Внизу страницы, под Supplemental Software щелкают по ссылке для вашего примера.

      Ваш пример открывается в основном окне справки.

Элементы файла demos.xml

Общая информация в <демонстрациях>

В файле demos.xml корневым тегом является <demos>. Этот тег включает элементы, которые определяют содержимое основной страницы для ваших примеров.

XML-ТЭГ

Примечания 

<name>

Имя вашего тулбокса или набор примеров.

<type>

Возможными значениями является matlab, simulink, toolbox или blockset.

<icon>

Проигнорированный в MATLAB R2015a и позже.

В предыдущих релизах этот значок был значком для вашего примера. В тех релизах можно использовать стандартный значок, HelpIcon.DEMOS. Или, можно обеспечить пользовательский значок путем определения пути к значку относительно местоположения файла demos.xml.

<description>

Описание, которое появляется на основной странице для ваших примеров.

<website>

(Необязательно) Ссылка на веб-сайт. Например, примеры MathWorks® включают ссылку на страницу продукта в https://www.mathworks.com.

Категории Используя <demosection>

Опционально, задайте категории для своих примеров включением <demosection> для каждой категории. Если вы включаете какие-либо категории, то все примеры должны быть в категориях.

Каждый элемент <demosection> содержит <label>, который обеспечивает название категории и связанные элементы <demoitem>.

Информация о каждом примере в <demoitem>

XML-ТЭГ

Примечания 

<label>

Задает заголовок, чтобы отобразиться в браузере.

<type>

Возможными значениями является M-file, model, M-GUI, video или other.

Как правило, если вы опубликовали свой пример с помощью опубликовать функции, соответствующим <type> является M-file.

<source>

Если <type> является M-file, model, M-GUI, то <source> является именем связанного файла .m или образцового файла без расширения. В противном случае не включайте элемент <source>, но включайте элемент <callback>.

<file>

Используйте этот элемент только для примеров со значением <type> кроме M-file когда это необходимо, чтобы отобразить файл HTML, который описывает пример. Задайте относительный путь от местоположения demos.xml.

<callback>

Используйте этот элемент только для примеров со значением <type> video или other, чтобы задать исполняемый файл или команду MATLAB, чтобы запустить пример.

<dependency>

(Необязательно) Задает другие продукты, требуемые запускать пример, такой как другой тулбокс. Текст должен совпадать с названием продукта, заданным в файле info.xml, который находится на пути поиска файлов или в текущей папке.
Документация MATLAB
Поддержка