11.10.1 옥타브 대본 기록철 게재

함수 publish로 대본 기록철을 동적으로 문서화합니다. 정적 문서화와 다르게, publish는 대본 기록철을 실행한 다음, 작동 중에 나온 모든 수치와 출력를 저장하여, 적절한 출력 형식으로 정적 문서 옆에 놓습니다. 정적 문서는 게재 조판 규칙으로 질을 높이고 출력을 맞춤 지정하여 만듭니다.

publish (기록철)

publish (기록철, 출력_형식)

publish (기록철, 선택1, 값1, …)

publish (기록철, 선택)

출력_기록철 = publish (기록철, …)

옥타브 대본 기록철 기록철을 여러가지 출력 형식 중 하나에 맞추어 보고서를 만듭니다.

만든 보고서는 주석에 그누 옥타브 사용설명서에 자세하게 기술된 모든 게재 조판 규칙을 설명합니다. 아래 예시를 조판 규칙을 사용한 대본 기록철 pub_example.m의 일부로 가정하십시오.

## 제목
#
# *두껍움*, _기울임_, 또는 |고정폭| 글월
# <https://www.octave.org *그누 옥타브* 연결 주소>.
##

# 평가할 "진짜" 옥타브 명령
이러쿵저러쿵 ()

%% 매트랩 주석 맵시('%')도 지원합니다.
%
% * 둥근 글머리 기호 항목 1
% * 둥근 글머리 기호 항목 2
%
% # 숫자 글머리 기호 항목 1
% # 숫자 글머리 기호 항목 2

이 대본 기록철을 게재하려면  publish ("pub_example.m")를 타자합니다.

기록철만 주면, 현재 작업 자료방의 하위 자료방 html에 초글월조판언어 보고서를 사용합니다. 옥타브 명령가 개별 문맥으로 평가되고, 대본 기록철을 실행할 때 생긴 모든 수치를 보고서에 포함합니다. 기록철의 모든 형식 있는 구문은 지정된 출력 형식에 따라 취급되며, 보고서에 포함됩니다.

publish (기록철, 출력_형식) 사용은 아래 구조체를 호출하는 함수와 똑같습니다.

options.format = 출력_형식;
publish (기록철, 선택)

선택/값 쌍을 사용하면 아래 구조체를 호출하는 함수와 똑같습니다.

options.option1 = 값1;
publish (기록철, 선택)

구조체 선택에는 아래 기록란 이름을 넣습니다. 기록란 이름을 주지 않으면, 기본값을 사용합니다.

• ‘format’ — 게재 대본 기록철의 형식입니다. 아래 중 하나를 사용합니다.

  ‘html’ (기본), ‘doc’, ‘latex’, ‘ppt’, ‘pdf’, ‘xml’.

  출력 형식 ‘doc’, ‘ppt’, ‘xml’은 현재 지원하지 않습니다. ‘doc’ 보고서를 만드려면, ‘html’ 보고서를 외부 도구로 변환하십시오.

  옥타브 맞춤 형식은 ‘__publish_<맞춤 형식>_output__.m’에 있는 모든 회신 메인 함수를 실행하여 지원합니다. 초글월조판언어 형식용 견본을 얻으려면 아래와 같이 타자합니다.

  edit (fullfile (fileparts (which ("publish")), ...
        "private", "__publish_html_output__.m"))
  

• ‘outputDir’ — 만든 보고서를 둘 절대 경로입니다. 이 값을 주지 않으면, 현재 작업 자료방의 하위 자료방 html에 보고서를 만듭니다.
• ‘stylesheet’ — 매트랩 호환용으로, 지원하지 않습니다.
• ‘createThumbnail’ —  매트랩 호환용으로, 지원하지 않습니다.
• ‘figureSnapMethod’ —  매트랩 호환용으로, 지원하지 않습니다..
• ‘imageFormat’ — 부호를 평가하는 동안 생성한 그림의 형식입니다. 가능한 그림 형식은 출력 형식에 따라 다릅니다.
  • ‘html’, ‘xml’ — ‘png’ (기본), 옥타브가 지원하는 모든 그림 형식
  • ‘latex’ — ‘epsc2’ (default), 옥타브가 지원하는 모든 그림 형식
  • ‘pdf’ — ‘jpg’ (default) 또는 ‘bmp’, 매트랩은 ‘bmp’을 기본으로 사용함에 유의하십시오.
  • ‘doc’, ‘ppt’ — ‘png’ (기본), ‘jpg’, ‘bmp’, ‘tiff’
• ‘maxWidth’과 ‘maxHeight’ — 만들 그림의 최대 화소 너비(높이)입니다.빈 값은 제한 없음을 뜻합니다. 두 값을 순서에 맞추어야 제대로 작동합니다.

  ‘[]’ (기본), 정수 값 ≥ 0

• ‘useNewFigure’ — 부호를 평가하는 도중에 생긴 값에 새 수치창을 사용합니다. 이미 열린 수치창에의 부작용을 피합니다.

  ‘true’ (기본) 또는 ‘false’

• ‘evalCode’ — 옥타브 원시 기록철의 부호를 평가합니다.

  ‘true’ (기본) 또는 ‘false’

• ‘catchError’ — 평가 중 오류가 발생하면, 오류를 잡아내고, 평가를 계속합니다.

  ‘true’ (기본) 또는 ‘false’

• ‘codeToEvaluate’ — 대본 기록철을 게재하려면 먼저 평가하여야 하는 옥타브 명령입니다. 이 옥타븐 명령은 만들어진 보고서에는 등장하지 않습니다.
• ‘maxOutputLines’ — 출력에 포함된 부호 평가에서 나온 최대 출력 줄 개수입니다.

  ‘Inf’ (기본) 또는 0보다 큰 정수

• ‘showCode’ — 만든 보고서에 평가한 옥타브 명령을 보여줍니다.

  ‘true’ (기본) 또는 ‘false’

선택 출력 출력_기록철에는 만든 보고서의 경로와 기록철 이름인 문자열이 들어갑니다.

같이 보기: grabcode.

grabcode가 publish의 반대 역할을 합니다.

grabcode (주소)

grabcode (기록철_이름)

부호_문자열 = grabcode (…)

publish 함수가 만든 보고서에서 부호를 끄집어냅니다.

게재된 보고서에서 끄집어낸 부호는 무조건 ‘##### SOURCE BEGIN #####’과 ‘##### SOURCE END #####’로 묶입니다. publish 함수가 자동으로 이 형식을 적용합니다.

반환값을 요청하지 않으면, 부호를 임시 기록철에 저장하고 기본 편집기로 엽니다. 안내: 임시 기록철을 무조건 새 기록철에 저장하여야 하며, 그렇지 않으면 지워집니다.

반환값을 요청하면, 끄집어낸 부호를 문자열 부호_문자열에 반환합니다.

예시:

publish ("my_script.m");
grabcode ("html/my_script.html");

위 예시는 my_script.m를 기본 위치 html/my_script.html에 게시합니다. 그리고 게시한 옥타브 대본의 내용을 수정하기 위하여 새 임시 기록철로 끄집어냅니다.

같이 보기: publish.