publish

지정한 형식으로 MATLAB 파일에 대한 보기 생성

구문

publish(file)

publish(file,format)

publish(file,Name,Value)

publish(file,options)

my_doc = publish(file,___)

설명

publish(file)은 지정된 MATLAB^® 코드 파일과 출력값의 보기를 공유에 사용할 수 있는 HTML 형식으로 생성합니다. publish는 이 HTML 파일과 코드가 생성하는 각 그래픽에 대한 파일을 html이라는 하위 폴더에 저장합니다. html 하위 폴더의 위치는 file의 위치에 상대적입니다.

예를 들어, publish('C:\myMATLABfiles\myfile.m')은 기본 작업 공간을 사용하여 myfile.m의 코드를 실행하고 형식 지정된 코드와 그 결과를 C:\myMATLABfiles\html\myfile.html로 저장합니다.

publish(file,format)은 지정된 MATLAB 파일의 보기를 지정한 파일 형식으로 생성합니다. 모든 파일 형식은 html 하위 폴더에 저장됩니다.

publish(file,Name,Value)는 지정된 MATLAB 파일의 보기를 하나 이상의 name,value 쌍의 인수로 지정된 옵션을 사용하여 생성합니다.

publish(file,options)는 지정된 MATLAB 파일의 보기를 options 구조체를 사용하여 생성합니다. 구조체를 사용하여 options를 지정하는 것은 반복 사용을 위해 사용자의 옵션을 미리 구성하고 저장하려고 할 때 유용합니다. options 구조체의 필드와 값은 이름-값 쌍 인수의 이름과 값에 대응합니다.

my_doc = publish(file,___)은 지정된 MATLAB 파일의 보기를 생성하고 그 결과로 생성되는 출력 파일의 경로를 반환합니다. 이 구문은 이전 구문의 모든 입력 인수 조합과 함께 사용할 수 있습니다.

예제

MATLAB 스크립트의 HTML 보기 생성하기

MATLAB 예제 스크립트의 HTML 보기를 코드, 결과, 주석을 포함하여 생성합니다. 그 결과로 생성되는 파일을 web 함수를 사용하여 봅니다.

publish("fourier_demo2.m");
web("html/fourier_demo2.html")

MATLAB 스크립트의 보기를 Microsoft Microsoft Word 형식으로 생성하기

MATLAB 예제 스크립트의 Microsoft^® Word 보기를 코드, 결과, 주석을 포함하여 생성합니다. 퍼블리시된 파일의 경로를 변수에 저장합니다. 그 결과로 생성되는 파일을 winopen 함수를 사용하여 봅니다.

mydoc = publish("fourier_demo2.m","doc");
winopen(mydoc)

이름-값 인수를 사용하여 MATLAB 스크립트의 보기를 사용자 지정하기

이름-값 인수를 사용하여 MATLAB 예제 스크립트의 HTML 보기에 포함되는 퍼블리시된 Figure 창의 모양을 변경합니다.

창 장식을 포함하고 Figure 배경색이 Figure의 화면 색과 일치하도록 figureSnapMethod 이름-값 인수를 entireFigureWindow 값과 함께 사용합니다. 그런 다음 그 결과로 생성되는 파일을 web 함수를 사용하여 봅니다.

publish("fourier_demo2.m","figureSnapMethod","entireFigureWindow");
web("html/fourier_demo2.html")

구조체를 사용하여 MATLAB 스크립트의 보기를 사용자 지정하기

스크립트의 코드를 표시하지 않도록 구조체에 설정해 두고서 MATLAB 예제 스크립트의 Microsoft Word 보기를 만듭니다. 옵션(options)을 구조체로 지정하는 것은 반복 사용을 위해 사용자의 옵션을 미리 구성하고 저장하려고 할 때 유용합니다.

format 옵션과 showcode 옵션을 지정하는 구조체 options를 만듭니다.

options.format = "doc";
options.showCode = false;

options에 지정된 옵션으로 예제의 Microsoft Word 보기를 생성합니다. 그 결과로 생성되는 파일을 winopen 함수를 사용하여 봅니다.

publish("fourier_demo2.m",options);
winopen("html/fourier_demo2.doc")

입력 인수를 사용하여 MATLAB 함수의 HTML 보기 생성하기

입력 인수를 필요로 하는 MATLAB 함수의 HTML 보기를 생성합니다.

함수 fact.m을 만들고 저장합니다.

%% FACT compute the factorial of a number
% FACT(N) computes the factorial of the number N and returns the results 
function f = fact(n)
    f = prod(1:n);
end

publish 함수를 사용하여 함수의 HTML 보기를 생성합니다. codeToEvaluate 이름-값 인수를 사용하여 입력 인수 n의 값을 설정합니다. 그런 다음 그 결과로 생성되는 파일을 web 함수를 사용하여 봅니다.

publish("fact.m","codeToEvaluate","fact(5);");
web("html/fact.html")

입력 인수

file — MATLAB 파일 이름

문자형 벡터 | string형

MATLAB 파일 이름으로, 문자형 벡터 또는 string형으로 지정됩니다. file은 전체 경로 또는 부분 경로를 포함할 수 있습니다.

참고

MATLAB은 파일을 퍼블리시할 때 file과 같은 이름으로 시작하는 출력 폴더에서 기존 파일을 덮어쓸 수 있습니다.

예: publish('myfile.m')

예: publish('C:\myMATLABfiles\myfile.m')

format — 출력 형식

'html' (디폴트 값) | 'doc' | 'latex' | 'ppt' | 'xml' | 'pdf'

퍼블리시된 파일의 출력 형식으로, 다음 표에 나열된 값 중 하나로 지정됩니다.

값	출력 형식
'html'(디폴트 값)	HTML(Hypertext Markup Language)
'doc'	Microsoft Word
'latex'	LaTeX
'ppt'	Microsoft PowerPoint®
'xml'	XML(Extensible Markup Language)
'pdf'	PDF(Portable Document Format)

Microsoft Word 및 Microsoft PowerPoint 형식은 Windows^® 플랫폼에서만 사용할 수 있습니다.

출력 형식을 Microsoft PowerPoint 또는 LaTeX으로 지정하면 MATLAB은 구문 강조 표시를 유지하지 않습니다.

예: publish('myfile.m','ppt');

options — 퍼블리시된 출력값에 대한 옵션

구조체

퍼블리시된 출력값에 대한 옵션으로, 구조체로 지정됩니다. 동일한 구성을 재사용하여 여러 개의 MATLAB 파일을 퍼블리시하려는 경우, 이름-값 쌍의 인수 대신 options 구조체를 사용하십시오.

options 구조체의 필드와 값은 이름-값 쌍 인수의 이름과 값에 대응합니다.

예를 들어, 다음 명령은 구조체 options를 생성하고 PDF 출력 형식과 출력 폴더 C:\myPublishedOutput을 지정합니다.

options = struct('format','pdf','outputDir','C:\myPublishedOutput')

이름-값 인수

선택적 인수 쌍을 Name1=Value1,...,NameN=ValueN으로 지정합니다. 여기서 Name은 인수 이름이고 Value는 대응값입니다. 이름-값 인수는 다른 인수 뒤에 와야 하지만, 인수 쌍의 순서는 상관없습니다.

R2021a 이전 릴리스에서는 쉼표를 사용하여 각 이름과 값을 구분하고 Name을 따옴표로 묶으십시오.

예: 'format','pdf','showCode',false는 출력 파일 형식을 PDF로 지정하고 출력 결과에서 코드를 제외합니다.

출력 옵션

format — 출력 형식

'html' (디폴트 값) | 'doc' | 'latex' | 'ppt' | 'xml' | 'pdf'

퍼블리시된 파일의 출력 형식으로, 다음 표에 나열된 값 중 하나로 지정됩니다.

값	출력 형식
'html'(디폴트 값)	HTML(Hypertext Markup Language)
'doc'	Microsoft Word
'latex'	LaTeX
'ppt'	Microsoft PowerPoint
'xml'	XML(Extensible Markup Language)
'pdf'	PDF(Portable Document Format)

Microsoft Word 및 Microsoft PowerPoint 형식은 Windows 플랫폼에서만 사용할 수 있습니다.

출력 형식을 Microsoft PowerPoint 또는 LaTeX으로 지정하면 MATLAB은 구문 강조 표시를 유지하지 않습니다.

예: publish('myfile.m','format','pdf')

outputDir — 출력 폴더

문자형 벡터

퍼블리시된 문서가 저장되는 출력 폴더로, 문자형 벡터로 지정됩니다. 폴더의 전체 경로를 지정합니다.

예: publish('myfile.m','outputDir','C:\myPublishedOutput')

stylesheet — XSL(Extensible Stylesheet Language) 파일

문자형 벡터

MATLAB 파일을 HTML, XML 또는 LaTeX 형식으로 퍼블리시할 때 사용할 XSL(Extensible Stylesheet Language) 파일로, 문자형 벡터로 지정됩니다. XSL 파일의 전체 경로를 지정합니다.

예: publish('myfile.m','stylesheet','C:\myStylesheet\stylesheet.xsl')

Figure 옵션

createThumbnail — 축소판 이미지 생성 여부

true (디폴트 값) | false

퍼블리시된 문서의 축소판 이미지 생성 여부로, true 또는 false로 지정됩니다. 생성된 축소판 이미지를 사용하여 HTML 페이지에 파일을 작게 표시할 수 있습니다.

figureSnapMethod — Figure 창 모양

'entireGUIWindow' (디폴트 값) | 'print' | 'getframe'

퍼블리시된 문서의 Figure 창 모양으로, 다음 표에 나열된 값 중 하나로 지정됩니다. Figure 창 모양은 플롯의 배경색, 창 장식(제목 표시줄, 도구 모음, 메뉴 모음, 창 테두리) 표시 여부를 포함합니다.

이 옵션은 MATLAB Online™에서 사용할 수 없습니다.

값	창 장식		배경색
	GUI	Figure	GUI	Figure
'entireGUIWindow'(디폴트 값)	포함됨	제외됨	화면의 모습과 일치함	흰색
'print'	제외됨	제외됨	흰색	흰색
'getframe'	제외됨	제외됨	화면의 모습과 일치함	화면의 모습과 일치함

imageFormat — 이미지 파일 형식

'png' | 'epsc2' | 'jpg' | ...

퍼블리시된 문서에 포함된 이미지의 이미지 파일 형식으로, 다음 표에 나열된 값 중 하나로 지정됩니다. 유효한 이미지 형식 목록은 지정되는 출력 형식에 따라 달라집니다.

출력 형식	유효한 이미지 형식	디폴트 이미지 형식
Microsoft Word	설치된 Microsoft Office 버전으로 가져오기가 가능한 이미지 형식('png', 'jpg', 'bmp', 'tiff' 포함). 'figureSnapMethod' 옵션을 'print'로 지정하면 'eps', 'epsc', 'eps2', 'ill', 'meta', 'pdf'도 지정할 수 있습니다.	'png'
HTML(Hypertext Markup Language)	모든 이미지 형식. 출력 파일을 보고 처리하는 데 사용하는 툴이 지정된 출력 형식을 표시할 수 있는지 확인하십시오.	'png'
LaTeX	모든 이미지 형식. 출력 파일을 보고 처리하는 데 사용하는 툴이 지정된 출력 형식을 표시할 수 있는지 확인하십시오.	'epsc2' 다음과 같은 경우에는 디폴트 값이 'png'로 변경됩니다. figureSnapMethod가 'getframe'임. figureSnapMethod가 'entireGUIWindow'이고 캡처된 창이 GUI 창임.
PDF(Portable Document Format)	'png'와 'jpg'.	'png'
Microsoft PowerPoint	설치된 Microsoft Office 버전으로 가져오기가 가능한 형식('png', 'jpg', 'bmp', 'tiff' 포함).	'png'
XML(Extensible Markup Language)	모든 이미지 형식. 출력 파일을 보고 처리하는 데 사용하는 툴이 지정된 이미지 형식을 표시할 수 있는지 확인하십시오.	'png'

maxHeight — 최대 이미지 높이

[] (디폴트 값) | 양의 정수

퍼블리시된 이미지의 최대 이미지 높이로, 다음 값 중 하나로 지정됩니다.

• [](디폴트 값) — 무제한 높이. 출력 형식이 PDF이면 항상 이 값이 사용됩니다

• 양의 정수 — 높이(단위: 픽셀).

maxWidth — 최대 이미지 너비

[] (디폴트 값) | 양의 정수

퍼블리시된 이미지의 최대 이미지 너비로, 다음 값 중 하나로 지정됩니다.

• [](디폴트 값) — 무제한 너비. 출력 형식이 PDF이면 항상 이 값이 사용됩니다

• 양의 정수 — 너비(단위: 픽셀).

useNewFigure — 새 Figure의 생성 여부

true (디폴트 값) | false

새 Figure의 생성 여부로, true 또는 false로 지정됩니다. true로 지정되어 코드가 Figure를 생성하는 경우, MATLAB은 퍼블리시를 수행하기 전에 흰색 배경과 디폴트 크기를 갖는 새 Figure 창을 생성합니다. false로 지정된 경우, MATLAB은 Figure 창을 생성하지 않습니다.

퍼블리시를 위해 다른 속성을 갖는 Figure를 사용하려는 경우에는 false 값을 지정하는 것이 유용합니다. 예를 들어, Figure 창을 열고 크기와 배경색을 변경한 후 코드를 퍼블리시할 수 있습니다. 퍼블리시된 문서의 Figure는 퍼블리시하기 전에 열었던 Figure의 특성을 사용합니다.

코드 옵션

evalCode — 코드 실행 여부

true (디폴트 값) | false

코드를 실행하고 퍼블리시된 보기에 MATLAB 출력값을 포함할지 여부로, true 또는 false로 지정됩니다.

catchError — 오류 포착 여부

true (디폴트 값) | false

퍼블리시 중에 오류를 포착할지 여부로, true 또는 false로 지정됩니다. true로 지정했는데 오류가 발생하면 MATLAB은 퍼블리시를 계속하고 퍼블리시된 파일에 오류를 포함합니다. false로 지정했는데 오류가 발생하면 MATLAB은 명령줄에 오류를 표시하고 퍼블리시된 파일을 생성하지 않습니다.

codeToEvaluate — 실행할 추가 코드

문자형 벡터

퍼블리시 중에 실행할 추가 코드로, 문자형 벡터로 지정됩니다. MATLAB 파일에 포함되지 않은 코드를 실행하려면 이 옵션을 사용하십시오. 예를 들어, 함수를 퍼블리시할 때 입력 인수의 값을 설정할 수 있습니다.

이 옵션을 지정하지 않으면 MATLAB은 퍼블리시하는 MATLAB 파일에 있는 코드만을 실행합니다.

예: publish('myfunction.m','codeToEvaluate','myfunction(1,10)')

maxOutputLines — 최대 라인 수

Inf (디폴트 값) | 음이 아닌 정수 값

퍼블리시된 문서에 포함할 출력값의 최대 라인 수로, 다음 값 중 하나로 지정됩니다.

• Inf(디폴트 값) — MATLAB은 퍼블리시된 문서에 모든 출력값을 포함합니다.

• 음이 아닌 정수 — MATLAB은 퍼블리시된 문서에 지정된 개수의 라인만 포함합니다. 더 적고 대표적인 출력값 샘플로 충분할 경우 이 옵션을 설정하면 유용합니다.

showCode — 코드 포함 여부

true (디폴트 값) | false

퍼블리시된 파일에 코드를 포함할지 여부로, true 또는 false로 지정됩니다.

출력 형식이 HTML인 경우, 'showCode' 옵션을 false로 설정했더라도 MATLAB은 퍼블리시된 HTML 파일의 끝에 코드를 주석으로 포함합니다. 코드가 주석으로 포함되면 파일에 코드가 표시되지 않더라도 grabcode 함수를 사용하여 HTML 파일에서 MATLAB 코드를 추출할 수 있습니다. MATLAB이 코드를 주석으로 포함하므로, 이 코드는 웹 브라우저에 표시되지 않습니다.

제한 사항

• 라이브 스크립트나 함수를 퍼블리시하는 것은 지원되지 않습니다. 라이브 스크립트나 함수를 다른 형식으로 변환하려면 export 함수를 대신 사용하십시오.

• 라이브 스크립트 또는 함수(.mlx)에서 publish 함수를 호출하여 MATLAB 코드 파일(.m)을 퍼블리시하는 것은 지원되지 않습니다.

• publish 함수는 input 함수를 지원하지 않습니다. input 함수에 대한 호출이 포함된 MATLAB 코드 파일(.m)을 퍼블리시하면 오류가 발생합니다.

팁

• 퍼블리시된 문서의 가독성을 높이고 추가 이미지 스냅샷, 외부 파일 콘텐츠 및 외부 이미지를 포함하려면 마크업 퍼블리시하기(Publishing Markup) 항목을 참조하십시오.

• MATLAB 코드 파일을 퍼블리시할 때 스냅샷이 중복되지 않게 하려면 publish 함수를 호출하기 전에 커서가 Figure 위에 놓여 있지 않은지 확인하십시오. 커서가 Figure에 있으면 Figure가 업데이트되고 publish 함수가 중복된 스냅샷을 생성할 수 있습니다.

버전 내역

R2006a 이전에 개발됨

R2025a: figureSnapMethod 이름-값 인수에 대해 "entireFigureWindow" 값이 더 이상 지원되지 않음

figureSnapMethod 이름-값 인수를 "entireFigureWindow"로 지정하는 것은 더 이상 지원되지 않습니다. "entireGUIWindow", "print" 또는 "getframe" 값을 대신 사용하십시오.

R2025a: "pdf" format 또는 "print" figureSnapMethod 이름-값 인수를 사용할 때 이름-값 인수 imageFormat에 값 "bmp"를 사용하는 것은 더 이상 지원되지 않음

format 이름-값 인수의 값이 "pdf"인 경우 imageFormat 이름-값 인수를 "bmp"로 지정하는 것은 더 이상 지원되지 않습니다. 이러한 변경의 결과로, PDF의 경우 imageFormat을 "png" 또는 "jpg"로 대신 지정할 수 있으며, 디폴트 값은 "png"입니다. figureSnapMethod 이름-값 인수의 값이 "print"인 경우 imageFormat 이름-값 인수를 "bmp"로 지정하는 것도 더 이상 지원되지 않습니다.

R2025a: 퍼블리시된 문서에서 기본적으로 Figure가 더 크게 표시되고 탭으로 표시됨

기본적으로 문서를 퍼블리시할 때 생성된 Figure는 이전 릴리스에서보다 더 크게 표시됩니다. 또한 이러한 Figure는 Figure 컨테이너에서 탭으로 표시됩니다.

이전의 디폴트 Figure 크기를 사용하여 문서를 퍼블리시하려면 [left bottom width height] 형식의 위치 벡터를 사용하여 각 Figure의 Position 속성을 설정하십시오. Position 속성을 설정하면 Figure 컨테이너에서 Figure가 도킹 해제됩니다.

f = figure(Position=[100 100 560 420]);

모든 Figure에 이전의 디폴트 초기 Figure 크기를 사용하려면 그래픽스 root 객체의 디폴트 Figure 위치를 설정하십시오.

set(groot,DefaultFigurePosition=[100 100 560 420])

자세한 내용은 Figure를 참조하십시오.

R2024b: figureSnapMethod 옵션에 대한 'entireFigureWindow' 값은 지원되지 않을 예정임

figureSnapMethod 옵션에 대한 'entireFigureWindow' 값은 향후 릴리스에서 지원되지 않을 예정입니다. 'entireGUIWindow', 'print' 또는 'getframe' 값을 대신 사용하십시오.

참고 항목

grabcode | snapnow | web | winopen | export

도움말 항목

• MATLAB 코드 퍼블리시 및 공유하기
• 마크업 퍼블리시하기(Publishing Markup)
• 라이브 스크립트와 라이브 함수를 공유하고 내보내는 방법