Binder 문서를 슬라이드 초안으로 조립하기

Binder slide draft assembly는 여러 문서를 복사해 하나로 합치는 기능이 아니다. Glif가 Binder의 순서, 문서별 Slide projection 선택, pitch와 summary를 읽어 새 발표 초안을 만든다. 원본 문서는 그대로 남고 결과는 다시 편집·탐색할 수 있는 Markdown 문서가 된다.

완성 결과

이 실습을 마치면 다음을 확인할 수 있다.

  • _index.md는 Binder 소개 divider가 된다.
  • Slide projection으로 선택한 문서만 내용 slide 후보가 된다.
  • pitch가 있으면 우선 사용하고, 없으면 summary를 사용한다.
  • 후보 문서에 두 값이 모두 없으면 본문을 임의로 요약하지 않고 제외한다.
  • 생성 순서는 별도 slide 순서가 아니라 Binder의 canonical order를 따른다.
  • 실행할 때마다 기존 원본과 이전 draft를 덮어쓰지 않는다.

Binder의 divider, pitch, summary를 새 slide draft로 조립하는 흐름

예제 Binder 준비

binder-slide-assembly-lab을 내려받아 Binder로 연다.

문서 projection metadata 조립 결과
_index.md 일반 Binder index title, description divider slide
01_product-idea.md Slide pitch pitch bullet slide
02_evidence.md Slide summary summary fallback slide
03_working-notes.md 일반 문서 pitch 후보가 아니므로 제외
04_empty-candidate.md Slide 없음 body fallback 없이 제외

.glif/projections.json은 첫 번째, 두 번째와 네 번째 일반 문서를 Slide 후보로 지정한다. 새 문서에서 직접 준비하려면 문서를 열고 문서 작업 화면 → 슬라이드 프로젝션 만들기를 선택한다. slide: true front matter를 새로 쓰는 방식은 현재 후보 계약이 아니다.

1. 조립 전 원본을 확인한다

먼저 01_product-idea.md와 02_evidence.md를 열어 front matter의 발표 입력을 확인한다.

title: 문서는 자산이다
pitch:
  - 다양한 문서와 에셋을 Markdown으로 모은다.
  - 하나의 원문을 여러 방식으로 표현한다.

pitch와 summary는 긴 본문을 자동 요약한 값이 아니라 작성자가 공개·발표 재사용을 위해 고른 문장이다. 중복되거나 빈 bullet은 조립할 때 정리된다.

조립 전 Binder 문서와 Slide 후보를 확인한 화면

2. Binder 메뉴에서 초안을 만든다

  1. 왼쪽 Shelf 상단에서 현재 Binder 이름을 확인한다.
  2. 탐색/작업 기준 메뉴를 연다.
  3. 슬라이드 초안 만들기를 선택한다.
  4. 성공 알림과 새 binderSlider.md tab을 확인한다.

Binder 기준 메뉴에서 슬라이드 초안 만들기를 선택하는 화면

3. 생성된 Markdown을 읽는다

결과 문서에는 generated delivery marker와 각 slide의 원본 경로가 주석으로 남는다.

<!-- generated-by: glif binder slide draft assembly -->

<!-- source: _index.md -->
# 문서 자산 발표

---

<!-- source: 01_product-idea.md -->
# 문서는 자산이다

- 다양한 문서와 에셋을 Markdown으로 모은다.

source marker는 어느 문서에서 발표 항목이 왔는지 추적하는 정보다. 결과를 편집해도 원본 문서 본문을 조용히 다시 쓰지 않는다.

생성된 binderSlider Markdown과 source marker

4. Slide workspace에서 결과를 확인한다

생성된 문서는 Slide projection으로 열리며 divider와 두 개의 content slide를 순서대로 확인할 수 있다. 현재 Glif Slide renderer가 화면의 기준이다. legacy Marp 입력을 호환해 읽을 수는 있지만 별도 Marp HTML이 현재 output authority는 아니다.

생성된 Binder slide draft를 Slide workspace에서 확인한 화면

5. 같은 Binder에서 다시 실행한다

기존 binderSlider.md가 있으면 Glif는 덮어쓰지 않고 binderSlider-2.md, binderSlider-3.md처럼 다음 빈 이름을 사용한다. 초안을 다시 만들기 전에 이전 결과를 지우거나 이름을 바꿀 필요가 없다.

이 동작은 자동 동기화가 아니다. 원본의 pitch를 고친 뒤 기존 draft가 저절로 바뀌지는 않는다. 새 초안을 만들고 두 결과를 비교한 뒤 필요한 쪽을 편집·보관한다.

후보가 하나도 없을 때

divider와 유효한 content slide가 모두 없으면 새 파일을 만들지 않고 “슬라이드 후보가 없습니다”라고 안내한다.

다음 순서로 확인한다.

  1. 문서를 Slide projection으로 선택했는가?
  2. pitch 또는 summary에 한 줄 이상의 값이 있는가?
  3. 번역 variant 파일만 후보로 둔 것은 아닌가?
  4. 현재 Binder가 실제 작업 기준으로 선택되어 있는가?

guide.ko.md, guide.en.md 같은 locale variant는 기본 Binder draft에서 중복 포함하지 않는다. 번역별 deck 조립은 별도 선택·배포 정책이 필요한 후속 범위다.

원본 보존 검증

조립 전후 다음 파일의 hash를 비교한다.

_index.md
01_product-idea.md
02_evidence.md
03_working-notes.md
04_empty-candidate.md

새 binderSlider.md와 projection 설정 외에 이 다섯 원본의 byte가 바뀌면 성공으로 판정하지 않는다. 조립은 source mutation이 아니라 새 output draft 생성이다.

Preview와 publish 경계

Slide workspace와 deck preview는 발표 결과를 확인하는 단계다. 이것만으로 public deploy가 완료되지는 않는다. 웹 게시가 필요하면 Output Workbench와 Preview에서 publish copy를 확인하고, provider 배포 결과·URL·rollback 상태는 배포와 운영에서 별도로 검증한다.

빠른 점검표

  • Binder 순서대로 divider와 content slide가 만들어졌다.
  • pitch가 summary보다 우선했다.
  • 일반 문서와 빈 후보가 제외됐다.
  • 생성 문서에 source marker가 남았다.
  • 원본 다섯 파일의 byte가 보존됐다.
  • 재실행이 기존 draft를 덮어쓰지 않았다.
  • preview와 public deploy를 같은 성공으로 표현하지 않았다.