Main Content

퍼블리시에 대한 출력 기본 설정

퍼블리시 옵션을 편집하는 방법

코드에 입력 인수를 지정하지 않고 HTML로 퍼블리시하려는 경우에는 디폴트 퍼블리시 기본 설정을 사용합니다. 그러나 코드에 입력 인수가 필요하거나, 출력 설정, 코드 실행, Figure 형식 중 하나를 지정하려는 경우에는 사용자 지정 구성을 지정하십시오.

  1. 퍼블리시 탭으로 이동하고 퍼블리시 drop-down arrow를 선택합니다.

  2. 퍼블리시 옵션 편집을 선택합니다.

  3. 구성 편집 대화 상자에서 출력 기본 설정을 지정합니다.

    MATLAB 표현식 창에서 퍼블리시하는 중에 실행되는 코드를 지정합니다. 퍼블리시 설정 창에서는 출력, Figure, 코드 실행 옵션을 지정합니다.

    MATLAB®에서는 이러한 창을 통칭하여 퍼블리시 구성이라고 합니다. MATLAB은 각 퍼블리시 구성을 .m 파일과 연결합니다. 퍼블리시 구성 이름은 대화 상자 맨 위에 표시되며 편집 가능합니다.

Sample Edit Configurations dialog box. On the left is a pane for searching and filtering the list of configurations for the file. On the right, from top to bottom, are the publish configuration name editable text field, the MATLAB expression pane, and the Publish settings pane.

출력 파일 지정하기

퍼블리시 설정 창에서 출력 형식과 위치를 지정합니다.

MATLAB은 다음과 같은 형식으로 퍼블리시합니다.

형식참고
htmlHTML 문서로 퍼블리시합니다. XSL(Extensible Stylesheet Language) 파일을 사용할 수 있습니다.
xmlXML 문서로 퍼블리시합니다. XSL(Extensible Stylesheet Language) 파일을 사용할 수 있습니다.
latexLaTeX 문서로 퍼블리시합니다. 구문 강조는 유지하지 않습니다. XSL(Extensible Stylesheet Language) 파일을 사용할 수 있습니다.
docMicrosoft® Word 문서로 퍼블리시합니다. 구문 강조는 유지하지 않습니다. 이 형식은 Windows® 플랫폼에서만 사용할 수 있습니다.
pptMicrosoft PowerPoint® 문서로 퍼블리시합니다. 구문 강조는 유지하지 않습니다. 이 형식은 Windows 플랫폼에서만 사용할 수 있습니다.
pdf PDF 문서로 퍼블리시합니다.

참고

XSL 파일을 사용하면 출력 문서의 모양을 더 세부적으로 제어할 수 있습니다. 자세한 내용은 https://docbook.sourceforge.net/release/xsl/current/doc/ 항목을 참조하십시오.

퍼블리시하는 중 코드 실행하기

코드 지정

기본적으로 MATLAB은 사용자가 퍼블리시하도록 요청한 .m 파일을 퍼블리시하면서 실행합니다. 사용자는, 이러한 과정에서도 MATLAB 표현식 창에서 임의의 유효한 MATLAB 코드를 지정할 수 있습니다. 예를 들어, 입력값이 필요한 함수를 퍼블리시하려는 경우 명령 function(input)을 실행합니다. 출력값을 퍼블리시하려는 추가 코드가 함수 호출 후에 나타납니다. MATLAB 표현식 영역을 지우면 MATLAB은 코드를 실행하지 않고 파일을 퍼블리시합니다.

참고

퍼블리시 구성은 MATLAB 기본 작업 공간을 사용합니다. 따라서 MATLAB 표현식 창의 변수는 기본 작업 공간의 기존 변수 값을 덮어씁니다.

코드 실행

퍼블리시하는 중에 MATLAB이 무엇을 실행할지에 영향을 주는 또 다른 방법은 퍼블리시 설정 창에서 코드 실행 옵션을 설정하는 것입니다. 이 옵션은 퍼블리시되는 .m 파일의 코드를 MATLAB이 실행해야 할지 여부를 나타냅니다. true로 설정하면, MATLAB은 코드를 실행하고 그 결과를 출력 문서에 포함시킵니다.

코드 실행 옵션을 false로 설정할 경우 MATLAB은 코드를 실행(평가)하지 않고 코드 결과도 포함시키지 않기 때문에, 파일에 유효하지 않은 코드가 있을 수 있습니다. 따라서, 이 옵션을 true로 설정하여 파일을 먼저 실행해 보는 것이 좋습니다.

예를 들어, 파일에 주석 텍스트 Label the plot을 포함하면서 그 앞에 주석 문자를 넣는 것을 깜빡 잊었다고 가정하겠습니다. 이 문서를 HTML로 퍼블리시하고 코드 실행 옵션을 true로 설정하면 출력물에 오류가 포함됩니다.

Published document with syntax-highlighted code and the resulting error in gray text

publish 함수가 포함된 파일을 퍼블리시하려면 false 옵션을 사용하십시오. 그렇지 않으면 MATLAB이 파일을 재귀적으로 퍼블리시하려고 시도합니다.

코드 포함

최종 출력물에 MATLAB 코드를 표시할지 여부를 지정할 수 있습니다. 코드 포함 옵션을 true로 설정하면 MATLAB은 퍼블리시된 출력 문서에 코드를 포함시킵니다. false로 설정할 경우 MATLAB은 HTML을 제외한 모든 출력 파일 형식에서 코드를 제외시킵니다.

출력 파일 형식이 HTML인 경우 MATLAB은 코드를 웹 브라우저에 표시되지 않는 HTML 주석으로 삽입합니다. 출력 HTML 파일에서 코드를 추출하려면 MATLAB grabcode 함수를 사용하면 됩니다.

예를 들어, 코드 포함 옵션이 false로 설정된 퍼블리시 구성을 사용하여 H:/my_matlabfiles/my_mfiles/sine_wave.m을 HTML로 퍼블리시한다고 가정하겠습니다. 출력물을 동료와 공유하면, 동료는 웹 브라우저에서 이 출력물을 볼 수 있습니다. 이 출력물을 생성한 MATLAB 코드를 보기 위해 동료는 sine_wave.html이 포함된 폴더에서 다음 명령을 실행할 수 있습니다.

grabcode('sine_wave.html')
그러면 MATLAB은 편집기에 sine_wave.html을 만든 파일을 엽니다.

오류 캐치

퍼블리시하는 중에 발생하는 모든 오류를 캐치하고 퍼블리시할 수 있습니다. 오류 캐치 옵션을 true로 설정하면 출력 문서에 모든 오류 메시지가 포함됩니다. 오류 캐치false로 설정하면 MATLAB은 코드 실행 중에 오류가 발생할 경우 퍼블리시 작업을 종료합니다. 단, 코드 실행 속성을 false로 설정할 경우 이 옵션은 아무런 영향을 미치지 않습니다.

출력물의 양 제한

퍼블리시 설정 창에서 최대 출력 라인 수 # 옵션을 지정하여 출력 문서에 포함되는 코드 출력값의 라인 수를 제한할 수 있습니다. 더 적고 대표적인 코드 출력값 샘플로 충분할 경우 이 옵션을 설정하면 유용합니다.

예를 들어, 다음 루프는 최대 출력 라인 수 #을 더 작은 값으로 설정하지 않는 한 퍼블리시된 출력물에 100개의 라인을 생성합니다.

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

출력물을 퍼블리시할 때 그래픽스 조작하기

이미지 형식 선택

퍼블리시할 때, MATLAB이 코드 실행 중에 생성된 그래픽스를 저장하는 데 사용할 이미지 형식을 선택할 수 있습니다. 드롭다운 목록에 표시되는 이미지 형식은 Figure 캡처 메서드 옵션의 설정에 따라 다릅니다. 호환성을 최대화하기 위해서는, 다음 표에 지정된 디폴트 형식을 선택하십시오.

출력 파일 형식디폴트 이미지 형식포함시킬 수 있는 이미지 유형
docpng

설치된 Microsoft Office 버전에서 지원하는 모든 형식.

htmlpng

모든 형식이 성공적으로 퍼블리시됩니다. 출력 파일을 보고 처리하는 데 사용하는 툴이 지정된 출력 형식을 표시할 수 있는지 확인하십시오.

latexpng 또는 epsc2

모든 형식이 성공적으로 퍼블리시됩니다. 출력 파일을 보고 처리하는 데 사용하는 툴이 지정된 출력 형식을 표시할 수 있는지 확인하십시오.

pdfbmp

bmpjpg.

pptpng

설치된 Microsoft Office 버전에서 지원하는 모든 형식.

xmlpng

모든 형식이 성공적으로 퍼블리시됩니다. 출력 파일을 보고 처리하는 데 사용하는 툴이 지정된 출력 형식을 표시할 수 있는지 확인하십시오.

이미지 크기 설정

구성 편집 대화 상자의 퍼블리시 설정 창에서 MATLAB이 생성하는 이미지의 크기를 설정할 수 있습니다. 이미지 크기를 픽셀 단위로 지정하여 출력물에 표시되는 이미지의 너비와 높이를 제한합니다. MATLAB은 이미지의 종횡비를 유지하므로, 이 픽셀 값은 최대 크기 값으로 반영됩니다. 다음과 같은 경우 MATLAB은 크기 설정을 무시합니다.

  • 외부 그래픽스를 사용하는 경우(외부 그래픽스 항목의 설명 참조)

  • .eps와 같은 벡터 형식을 사용하는 경우

  • .pdf로 퍼블리시하는 경우

Figure 캡처

Figure 캡처 메서드 옵션을 설정하여 Figure 창의 다양한 특성을 캡처할 수 있습니다. 이 옵션은 Figure 창의 창 장식(제목 표시줄, 도구 모음, 메뉴 모음, 창 테두리)과 플롯 배경을 지정합니다.

다음 표에는 다양한 Figure 캡처 메서드에 따른 영향이 요약되어 있습니다.

사용할 Figure 캡처 메서드결과적으로 표시되는 Figure 캡처 모양의 세부 사항
 창 장식플롯 배경

entireGUIWindow

대화 상자의 경우 포함됨. Figure의 경우 제외됨Figure의 경우 흰색으로 설정됨. 대화 상자의 경우 화면과 일치됨

print

대화 상자와 Figure의 경우 모두 제외됨흰색으로 설정됨

getframe

대화 상자와 Figure의 경우 모두 제외됨화면 플롯 배경과 일치됨

entireFigureWindow

대화 상자와 Figure의 경우 모두 포함됨화면 플롯 배경과 일치됨

참고

일반적으로 MATLAB Figure는 HandleVisibility 속성이 on으로 설정되어 있습니다. 대화 상자는 HandleVisibility 속성이 offcallback으로 설정된 Figure입니다. 결과가 위 표에 설명된 것과 다르게 표시될 경우에는 Figure나 대화 상자의 HandleVisibility 속성이 다르게 설정되어 있을 수 있습니다. 자세한 내용은 HandleVisibility 항목을 참조하십시오.

사용자 지정 Figure 창 지정

MATLAB에서는 생성되는 Figure의 모양을 사용자 지정할 수 있습니다. 퍼블리시 설정 창의 새 Figure 사용 옵션이 true로 설정된 경우 MATLAB은 퍼블리시된 출력물에 디폴트 크기와 흰색 배경을 갖는 Figure 창을 사용합니다. 새 Figure 사용 옵션이 false로 설정된 경우에는 열려 있는 Figure 창의 속성을 사용하여, 코드에서 생성되는 Figure의 모양을 결정합니다. 이 기본 설정은 외부 그래픽스에 나와 있는 구문을 사용하여 포함된 Figure에는 적용되지 않습니다.

다음 코드를 템플릿으로 사용하여 요구에 부합하는 Figure 창을 생성하십시오.

% 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'});

Figure window with a purple background and a subplot with a title and axes labels

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

이 창이 열려 있는 상태에서 새 Figure 사용 옵션을 false로 설정하여 파일을 퍼블리시하면, 코드에서 생성되는 Figure에는 열려 있는 이 Figure 창의 속성이 적용됩니다.

참고

퍼블리시된 최종 Figure에 열려 있는 Figure 창의 모든 속성이 표시되도록 하려면 Figure 캡처 메서드 옵션을 entireFigureWindow로 설정해야 합니다.

축소판 생성

코드에서 생성되는 첫 번째 그래픽을 축소판 이미지로 저장할 수 있습니다. 이 축소판을 사용하여 HTML 페이지에 파일을 나타낼 수 있습니다. 축소판을 만들려면 다음 단계를 따르십시오.

  1. 퍼블리시 탭에서 퍼블리시 drop-down arrow를 클릭하고 퍼블리시 옵션 편집을 선택합니다. 구성 편집 대화 상자가 열립니다.

  2. 이미지 형식 옵션을 .png.jpg와 같은 비트맵 형식으로 설정합니다. 그러면 MATLAB이 비트맵 형식의 축소판 이미지를 생성합니다.

  3. 축소판 만들기 옵션을 true로 설정합니다.

    MATLAB은 퍼블리시 설정 창의 출력 폴더 옵션에 지정된 폴더에 축소판 이미지를 저장합니다.

퍼블리시 설정 저장하기

퍼블리시 설정을 저장하여, 나중에 출력물을 쉽게 재현할 수 있습니다. 주로 사용하는 퍼블리시 설정을 저장하면 유용할 수 있습니다.

Sample Publish settings pane in the Edit Configurations dialog box with a Save As button

퍼블리시 설정 옵션이 설정되어 있으면 다음 단계를 따라 이 설정을 저장할 수 있습니다.

  1. 옵션이 원하는 대로 설정되었으면 다른 이름으로 저장을 클릭합니다.

    다른 이름으로 퍼블리시 설정 저장 대화 상자가 열리고 현재 정의되어 있는 모든 퍼블리시 설정의 이름이 표시됩니다. 기본적으로 다음과 같은 퍼블리시 설정이 MATLAB과 함께 설치됩니다.

    • 공장 초기값

      공장 초기값은 덮어쓸 수 없으며, 퍼블리시 설정 목록에서 공장 초기값을 선택하여 디폴트 설정값으로 되돌릴 수 있습니다.

    • 사용자 디폴트 값

      처음에 사용자 디폴트 값 설정은 공장 초기값 설정과 동일합니다. 사용자 디폴트 값 설정은 덮어쓸 수 있습니다.

  2. 설정 이름 필드에 의미를 갖는 설정 이름을 입력합니다. 그런 다음 저장을 클릭합니다.

    이제 다른 MATLAB 파일에서 이 퍼블리시 설정을 사용할 수 있습니다.

    기존 이름으로 저장된 퍼블리시 속성을 덮어쓸 수도 있습니다. 퍼블리시 설정 목록에서 이름을 선택한 다음 덮어쓰기를 클릭합니다.

퍼블리시 구성 관리하기

MATLAB 표현식 창의 코드와 퍼블리시 설정 창의 설정이 합쳐져, 하나의 파일과 연결된 퍼블리시 구성이 됩니다. 이러한 구성을 통해 개별 파일의 퍼블리시 기본 설정을 간단하게 참조할 수 있습니다.

퍼블리시 구성을 만들려면 퍼블리시 탭에서 퍼블리시 drop-down arrow를 클릭하고 퍼블리시 옵션 편집을 선택하십시오. 디폴트 퍼블리시 기본 설정이 포함된 구성 편집 대화 상자가 열립니다. 퍼블리시 구성 이름 필드에 퍼블리시 구성 이름을 입력하거나 디폴트 이름을 그대로 사용합니다. 퍼블리시 구성이 자동으로 저장됩니다.

기존 퍼블리시 구성 실행

퍼블리시 구성을 저장한 후에는, 다음과 같이 구성 편집 대화 상자를 열지 않고도 퍼블리시 구성을 실행할 수 있습니다.

  1. 퍼블리시 drop-down arrow를 클릭합니다. 마우스 포인터를 퍼블리시 구성 이름 위로 가져가면 MATLAB이 특정 구성과 연결된 MATLAB 표현식을 보여주는 툴팁을 표시합니다.

  2. 퍼블리시 구성에 사용할 구성 이름을 선택합니다. MATLAB은 이 구성과 연결된 코드와 퍼블리시 설정을 사용하여 파일을 퍼블리시합니다.

하나의 파일에 대해 여러 개의 퍼블리시 구성 만들기

지정된 파일에 대해 여러 개의 퍼블리시 구성을 만들 수 있습니다. 입력 인수에 서로 다른 값을 사용하거나, 퍼블리시 설정 속성값을 서로 다르게 지정하거나, 또는 이 둘을 모두 수행하여 파일을 퍼블리시하려는 경우가 해당될 수 있습니다. 각 목적에 맞게 명명된 구성을 만들어, 모두 동일한 파일에 연결합니다. 나중에 이 중 어느 것이든 원하는 특정 퍼블리시 구성을 실행할 수 있습니다.

다음 단계를 지침으로 활용하여 새 퍼블리시 구성을 만드십시오.

  1. 편집기에서 파일을 엽니다.

  2. 퍼블리시 버튼 드롭다운 화살표를 클릭하고 퍼블리시 옵션 편집을 선택합니다. 구성 편집 대화 상자가 열립니다.

  3. 왼쪽 창에 있는 추가 버튼 을 클릭합니다.

    구성 목록에 새 이름 filename_n이 나타납니다. 여기서 n 값은 기존 구성 이름에 따라 달라집니다.

    Configurations list pane with the name of the file being published at the top of the list and three named publish configurations underneath it

  4. MATLAB 표현식 또는 퍼블리시 설정 창에서 설정을 수정하면 MATLAB이 자동으로 변경 사항을 저장합니다.

퍼블리시 구성 다시 연결 및 이름 바꾸기

각 퍼블리시 구성은 특정 파일에 연결되어 있습니다. 파일을 이동하거나 파일 이름을 바꿀 경우 이 연결을 다시 정의해야 합니다. 파일을 삭제할 경우에는 연결된 구성을 삭제하거나 이 구성을 다른 파일과 연결할 수 있습니다.

MATLAB이 구성을 파일과 연결할 수 없을 경우에는, 구성 편집 대화 상자에 해당 파일 이름이 빨간색으로 표시되고 파일을 찾을 수 없음 메시지가 나타납니다. 구성을 다른 파일과 다시 연결하려면 다음 단계를 수행하십시오.

  1. 구성 편집 대화 상자의 왼쪽 창에서 검색란에 있는 지우기 버튼 을 클릭합니다.

  2. 퍼블리시 구성을 다시 연결할 파일을 선택합니다.

  3. 구성 편집 대화 상자의 오른쪽 창에서 선택...을 클릭합니다. 열기 대화 상자에서 구성을 다시 연결할 파일을 찾아 선택합니다.

구성 이름은 왼쪽 창의 목록에서 해당 구성을 선택하여 언제든지 바꿀 수 있습니다. 오른쪽 창에서 퍼블리시 구성 이름 값을 편집하십시오.

참고

파일 이름을 바꾼 후에 올바르게 실행하려면 MATLAB 표현식 창에서 코드 문을 변경해야 할 수도 있습니다. 예를 들어, 함수의 새 파일 이름을 반영하여 함수 호출을 변경해야 할 수 있습니다.

여러 시스템 간에 퍼블리시 구성 사용

구성 편집 대화 상자를 사용하여 퍼블리시 구성을 만들거나 저장할 때마다, 편집기는 기본 설정 폴더에 있는 publish_configurations.m 파일을 업데이트합니다. (기본 설정 폴더는 MATLAB에 함수 prefdir을 실행시키면 MATLAB이 반환값으로 알려주는 폴더입니다.)

한 시스템의 기본 설정 폴더에서 다른 시스템의 기본 설정 폴더로 이 파일을 이동할 수 있지만, publish_configurations.m 파일은 한 시스템에 하나만 있을 수 있습니다. 따라서, 이 두 번째 시스템에서 퍼블리시 구성을 만들지 않은 경우에만 해당 시스템으로 파일을 이동해야 합니다. 또한 publish_configurations.m 파일에는 파일 경로에 대한 참조가 포함되어 있을 수 있으므로, 지정된 파일과 경로가 이 두 번째 시스템에 있는지 확인해야 합니다.

MathWorks®에서는 MATLAB 편집기나 텍스트 편집기에서 publish_configurations.m을 업데이트하지 않을 것을 권장합니다. 구성 편집 대화 상자가 아닌 툴을 사용하여 변경한 내용은 나중에 덮어씌워질 수 있습니다.

관련 항목