Main Content

사용자 지정 예제 표시하기

예제를 표시하는 방법

MATLAB® 도움말 브라우저에 비디오, 퍼블리시된 프로그램 스크립트, 기타 프로그램 사용 설명 파일 등의 예제를 표시하려면 다음 단계를 따르십시오.

  1. 예제 파일을 만듭니다. 스크립트 또는 함수에서 예제를 만들려면 MATLAB에서 다음 두 가지 방법 중 하나를 사용하여 파일을 HTML 파일로 변환할 수 있습니다.

    툴박스의 모든 예제 파일과 지원 파일(예: PNG 및 CSS 파일)을 demos.xml 파일이 있는 폴더(또는 그 폴더의 하위 폴더)에 저장하십시오. 이 폴더는 다음 위치에 있어야 합니다.

    • MATLAB 검색 경로 내

    • matlabroot 폴더 외부

    • 설치된 하드웨어 지원 패키지 도움말 폴더 외부

  2. 예제의 이름, 유형, 표시 정보를 설명하는 demos.xml 파일을 만듭니다. 파일을 info.xml 파일이 있는 폴더(또는 폴더의 하위 폴더)에 넣습니다. info.xml 파일 생성에 대한 자세한 내용은 사용자 지정 문서 표시하기 항목을 참조하십시오.

    예를 들어, My Sample이라는 툴박스가 있으며 여기에 HTML로 퍼블리시된 my_example이라는 스크립트가 있다고 가정하겠습니다. 다음 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>
  3. 예제를 확인합니다.

    도움말 브라우저에서 홈 페이지로 이동합니다. 페이지 하단에 있는 추가 소프트웨어에서 예제 링크를 클릭합니다. 예제가 주 도움말 창에 열립니다.

    예제가 추가 소프트웨어에 표시되지 않으면 demos.xml 파일에 유효하지 않은 구문이 포함되어 있는 것일 수 있습니다.

demos.xml 파일의 요소

demos.xml 파일 내에서 <demos> 태그에 일반 정보를 포함하고, <demoitem> 태그를 사용하여 개별 예제를 정의하고, 원하는 경우 <demosection> 태그를 사용하여 범주를 정의할 수 있습니다.

<demos> 태그를 사용하여 일반 정보 포함하기

demos.xml 파일 내에서 루트 태그는 <demos>입니다. 이 태그에는 예제의 기본 페이지의 내용을 알려주는 요소가 포함되어 있습니다.

XML 태그

참고

<name>

툴박스나 예제 모음의 이름입니다.

<type>

가능한 값은 matlab, simulink, toolbox, blockset 중 하나입니다.

<icon>

MATLAB R2015a 이상에서는 무시됩니다.

이전 릴리스에서 이 아이콘은 예제에 쓰였던 아이콘이었습니다. 이러한 릴리스에서는 표준 아이콘인 HelpIcon.DEMOS를 사용할 수 있습니다. 또는, demos.xml 파일 위치에 대한 상대적 아이콘 경로를 지정하여 사용자 지정 아이콘을 제공할 수 있습니다.

<description>

예제의 기본 페이지에 나타나는 설명입니다.

R2021a부터는 demos.xml 파일의 설명에서 문자 데이터가 지원되지 않습니다. &lt;, &gt;, &apos;, &quot;, &amp;와 같은 문자 데이터가 포함된 demos.xml 파일이 있는 경우 도움말 브라우저에서 설명이 제대로 표시되지 않습니다. 기존의 문자 데이터를 문자가 아닌 데이터로 자동으로 바꾸려면 patchdemoxmlfile 함수를 사용하십시오.

<website>

(선택 사항) 웹 사이트 링크입니다. 예를 들어, MathWorks® 예제에는 https://www.mathworks.com에서의 제품 페이지 링크가 포함되어 있습니다.

<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>

예제를 설명하는 HTML 파일을 표시하려는 경우 M-file 이외의 <type> 값을 가진 예제에 대해서만 이 요소를 사용합니다. demos.xml의 위치에서 상대적인 경로를 지정합니다.

<callback>

예제를 실행할 실행 파일이나 MATLAB 명령을 지정하려면 <type> 값이 videoother인 예제에 대해서만 이 요소를 사용합니다.

<dependency>

(선택 사항) 예를 들어 또 다른 툴박스 같은, 예제 실행에 필요한 다른 제품을 지정합니다. 텍스트는 검색 경로나 현재 폴더에 있는 info.xml 파일에 지정된 제품 이름과 일치해야 합니다.

<demosection> 태그를 사용하여 범주 정의하기

선택적으로, 각 범주에 대한 <demosection>을 포함시켜 예제의 범주를 정의할 수 있습니다. 아무 범주라도 포함시키는 경우에는, 모든 예제가 범주에 있어야 합니다.

<demosection> 요소에는 범주 이름, 관련 <demoitem> 요소 등을 제공하는 <label>이 들어 있습니다.

참고 항목

관련 항목