사용자 지정 예제 표시하기

예제를 표시하는 방법

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

예제 파일을 만듭니다. 스크립트 또는 함수에서 예제를 만들려면 MATLAB에서 다음 두 가지 방법 중 하나를 사용하여 파일을 HTML 파일로 변환할 수 있습니다.
- 라이브 스크립트(*.mlx)를 생성하여 HTML로 내보냅니다. 자세한 내용은 라이브 스크립트와 라이브 함수를 공유하고 내보내는 방법 항목을 참조하십시오.
- 스크립트(*.m)를 생성하여 HTML로 퍼블리시합니다. 자세한 내용은 MATLAB 코드 퍼블리시 및 공유하기 항목을 참조하십시오.
툴박스의 모든 예제 파일과 지원 파일(예: PNG 및 CSS 파일)을 demos.xml 파일이 있는 폴더(또는 그 폴더의 하위 폴더)에 저장하십시오. 이 폴더는 다음 위치에 있어야 합니다.
- MATLAB 검색 경로 내
- matlabroot 폴더 외부
- 설치된 하드웨어 지원 패키지 도움말 폴더 외부

예제의 이름, 유형, 표시 정보를 설명하는 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>

예제를 확인합니다.
도움말 브라우저에서 홈 페이지로 이동합니다. 페이지 하단에 있는 추가 소프트웨어에서 예제 링크를 클릭합니다. 예제가 주 도움말 창에 열립니다.
예제가 추가 소프트웨어에 표시되지 않으면 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` 파일의 설명에서 문자 데이터가 지원되지 않습니다. `<`, `>`, `'`, `"`, `&`와 같은 문자 데이터가 포함된 `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>` 값이 `video`나 `other`인 예제에 대해서만 이 요소를 사용합니다.
`<dependency>`	(선택 사항) 예를 들어 또 다른 툴박스 같은, 예제 실행에 필요한 다른 제품을 지정합니다. 텍스트는 검색 경로나 현재 폴더에 있는 `info.xml` 파일에 지정된 제품 이름과 일치해야 합니다.