문서 출력과 출판 워크벤치
출력은 현재 화면을 그대로 저장하는 단일 명령이 아니다. 대상 문서와 순서, 형식별 설정, 포함·제외 범위, preflight와 결과 위치를 명시해야 다시 실행할 수 있다. 이 장은 Publication Definition을 만들고 Output Gate Workbench에서 여러 산출물을 검증하는 흐름을 설명한다.
출력 흐름
- 현재 문서 또는 Binder를 source로 선택한다.
- PDF, DOCX, EPUB, static artifact, executable package 또는 PWA 중 필요한 output을 추가한다.
- output별 template, page·resource, password·expiry와 결과 경로를 설정한다.
- preflight에서 누락된 resource, 지원하지 않는 요소와 충돌하는 설정을 해결한다.
- 여러 output을 실행하고 각 결과의 성공·실패를 독립적으로 확인한다.
- 결과 파일을 직접 열어 내용·순서·링크·이미지를 검사한다.
형식별 확인 기준
| 형식 | 우선 확인 | 흔한 실패 |
|---|---|---|
| 표지, page break, font, link | font 대체, overflow, template field 누락 | |
| DOCX | heading, list, table, image | 지원하지 않는 Markdown 요소 |
| EPUB | spine 순서, navigation, resource | 필수 resource·metadata 누락 |
| static artifact | route, asset, search | 잘못된 base path와 빠진 static file |
| package/PWA | 접근 제어, expiry, launch | password 주입, 임시 artifact 정리 실패 |
연속 예제
공용 예제의 brief, roadmap와 metrics를 하나의 Binder로 묶는다. Publication Definition에 PDF·DOCX·EPUB 세 output을 추가하고 같은 source ordering을 사용한다. PDF에는 표지를 적용하고, DOCX에서는 표가 편집 가능한 구조인지 확인하고, EPUB에서는 navigation과 이미지 resource를 검사한다.
결과와 원본의 관계
output은 다시 실행 가능한 파생 결과다. PDF나 package를 수정해도 Markdown 원본으로 자동 역동기화되지 않는다. 출력 경로와 실행 이력은 원본의 대체물이 아니며, 성공 toast만으로 실제 파일 검증을 생략하지 않는다.
문서 내보내기와 출판 워크벤치에서 현재 기능별 레퍼런스를 확인할 수 있다.
이 장의 상세 문서
- 정적 사이트 artifact 만들기: Binder를 Hugo 정적 파일로 만들고 route·asset·원본 보존을 검사한다.
- Folio 실행 패키지와 PWA: 출력 경로, 비밀번호·만료, 실행 파일, 공개 PWA와 보호 게시 경계를 검증한다.
- 출판 워크벤치로 여러 출력 묶기: 문서 순서·공통 메타데이터와 여러 output을 하나의 재실행 가능한 출판물 정의로 저장한다.
PB-27의 임시 작업 폴더 정리는 제품 내부 안전 계약이다. 사용자가 선택하거나 확인하는 공개 기능이 아니므로 이 매뉴얼의 기능 목록에는 넣지 않는다.
실제 output을 대조하는 화면
같은 Binder를 여러 형식으로 materialize하되, 성공 toast가 아니라 결과 파일을 직접 확인한다.
output별 재현 절차
- Binder의 문서 순서와 포함 asset을 기록한다.
- Publication Definition에 PDF, DOCX, EPUB 또는 static artifact를 추가한다.
- output별 preflight를 실행하고 누락 resource·지원 제한을 해결한다.
- 실행 후 결과 파일의 존재·크기·열림 여부를 확인한다.
- 원문 제목·heading·table·image·link 순서를 결과와 대조한다.
- 실패한 output만 재시도하고 성공한 결과를 덮어쓰지 않는다.
- 생성 결과와 source revision을 함께 기록한다.
결과 판정
| 판정 | 의미 | 다음 행동 |
|---|---|---|
| pass | 결과 파일과 핵심 내용이 source와 일치 | artifact를 보관 |
| warning | 제한이나 fallback이 있으나 결과는 열림 | warning과 범위를 함께 공개 |
| fail | 파일 생성·열기·resource 검증 실패 | source·설정·preflight로 복귀 |
| stale | 이전 revision의 결과가 남음 | 실행 이력과 source hash를 비교해 폐기 |
package와 PWA는 비밀번호·만료·접근 정책을 포함할 수 있으므로 공개 링크를 문서에 그대로 넣지 않는다. 보호 상태와 공개 상태를 별도 fixture로 검증한다.
이 장의 완료 기준
- Binder와 source revision이 고정되어 있다.
- 필요한 output 형식과 설정이 명시되어 있다.
- preflight warning·failure를 기록했다.
- 결과 파일을 직접 열어 내용과 resource를 확인했다.
- 성공 output과 실패 output을 독립적으로 보관했다.
- password·token·외부 URL이 캡처나 log에 노출되지 않았다.