Docs
출판 워크벤치

출판 워크벤치

출판 워크벤치

출판 워크벤치는 하나의 Binder 구조와 공통 메타데이터를 여러 결과물에 반복해서 사용하는 화면이다. Output 화면에서 출판 워크벤치를 열고 출판물을 만든 다음 PDF, Word(DOCX), EPUB 출력을 함께 실행할 수 있다.

출판물 만들기

  1. Binder를 열고 Output 화면으로 이동한다.
  2. 왼쪽의 출판 워크벤치를 선택한다.
  3. 새로 만들기를 누르고 제목, 부제, 저자, 언어와 설명을 입력한다.
  4. 왼쪽 Output Structure에서 문서 순서를 확인하고 현재 구성 사용으로 출판물에 저장한다.
  5. 필요한 PDF, DOCX, EPUB 출력을 켜고 저장한다.

여러 출판물을 만들면 같은 Binder에서도 본문판, 검토본처럼 서로 다른 메타데이터와 출력 조합을 따로 저장하고 다시 열 수 있다.

PDF와 DOCX 합본은 출판물 정의의 공통 메타데이터를 사용하며 각 원문 파일의 개별 frontmatter를 합본 메타데이터로 전달하지 않는다. 합본에 표시할 챕터 제목은 원문 본문의 Markdown 제목으로 작성한다.

현재 DOCX 출력은 제목, 문단, 링크, 표, 목록, 코드, 목차와 번호 매기기를 지원한다. 본문 이미지와 각주는 출력 전에 명시적으로 중단되며, 기존 DOCX 파일을 덮어쓰지 않는다.

모두 빌드와 재시도

모두 빌드는 실행을 시작할 때 문서 내용과 순서를 하나의 스냅샷으로 고정하고 선택한 출력을 순서대로 실행한다. 한 출력이 실패해도 뒤의 출력은 계속 실행되며 각 결과는 성공, 미리보기로 이동, 실패, 취소 또는 건너뜀으로 표시된다. 미리보기로 이동은 Web 파일이 완성됐다는 뜻이 아니라 기존 Preview 화면으로 작업이 넘어갔다는 뜻이다.

저장 대화상자를 닫으면 그 출력은 실패가 아니라 취소로 기록된다. 실패 항목 재시도는 같은 출판물과 같은 문서 스냅샷일 때만 실패한 출력에 사용된다. 그 사이 출판물 설정이나 원문이 바뀌었다면 새 모두 빌드 실행을 시작해야 한다.

Web 출력은 v1에서 파일을 자동 배포하지 않고 기존 미리보기 화면으로 이동한다. 형식별 조판과 세부 옵션은 기존 PDF, EPUB 등 각 출력 화면이 계속 소유한다.

저장하지 않은 출판물 변경이 있을 때 다른 출판물 선택, 새 출판물 만들기, 다른 Output 이동 또는 Output 화면 닫기를 시도하면 저장·버리기·취소 중 하나를 선택한다. 저장 실패나 취소가 발생하면 현재 출판물과 Output 화면을 그대로 유지한다.

문서 버전 릴리스

출판물을 저장하면 문서 버전에서 Binder 단위의 공개 버전을 명시적으로 만들고 관리할 수 있다. 자동 저장, 모두 빌드, 일반 배포는 버전을 자동으로 올리지 않는다.

  1. 새 버전 만들기에서 버전 ID, 표시 레이블과 URL 슬러그를 입력한다.
  2. 공개할 언어를 선택한다. 기본 언어는 항상 포함되며, 다른 언어는 준비된 번역 materialization이 있을 때 명시적으로 포함한다.
  3. 릴리스 사전 검토에서 추가·변경·삭제 문서 수, 예상 공개 용량, 포함 언어와 유지 버전 수를 확인한다.
  4. 검토 뒤 릴리스 의도 확인을 눌러 로컬 릴리스 generation을 만든다.

같은 공개 버전의 내용을 다시 고정하려면 현재 버전 업데이트를 사용한다. 버전을 지원, 지원 중단 예정, 보관 또는 공개 중지 상태로 바꿀 때는 수명 주기 변경을 사용한다. 기본 버전이나 다른 버전의 비교 기준을 바꾸는 전이에는 지원 중인 대체 버전을 함께 지정해야 한다.

생성된 Hugo 사이트에서는 독자가 공개된 버전을 selector로 전환할 수 있다. 비교 기준이 있는 버전은 이전 버전과의 추가·변경·삭제 차이를 정적으로 표시한다. 버전, 언어와 diff 데이터는 빌드 결과에 함께 고정되므로 브라우저에서 Git 저장소나 작성 중인 Binder를 직접 읽지 않는다.

현재 범위는 로컬 릴리스 생성과 정적 Hugo/Folio 결과 확인까지다. Deploy Git 원격 production 활성화는 기본적으로 꺼져 있으며, Workbench에서 릴리스 의도를 확인해도 외부 사이트를 자동 배포하지 않는다. 원격 활성화, 운영 ordering과 대규모 사이트의 production ceiling은 별도 검증 대상이다.

문제가 있을 때

  • 문서가 없다고 나오면 Output Structure를 확인하고 현재 구성 사용을 다시 누른다.
  • 다른 Binder의 출판물은 실행되지 않는다. 출판물이 속한 Binder를 연다.
  • 디스크에서 출판물 정의가 바뀌었다는 메시지가 나오면 목록에서 다시 불러온 뒤 변경한다.
  • 저장 대화상자를 취소한 출력은 필요할 때 다시 모두 빌드한다.
  • 릴리스 사전 검토 뒤 출판물이나 원문이 바뀌면 다시 사전 검토한다.
  • 릴리스 저장소 손상이나 사용할 수 없음이 표시되면 화면의 복구 동작으로 상태를 기록한 뒤 저장소를 복구하고 다시 시도한다.
사이트 게시 설정