Gallery를 Slide에서 재사용

같은 Markdown 이미지 구조를 발표 자료 안에서도 Gallery block으로 투영한다.

# 문서는 자산이다 — Slide Gallery

## 입력 게이트

![여러 입력이 모이는 장면](/examples/glif-guide-project/gallery-lab/Resources/input-gate.svg "다양한 입력")

![Markdown 원문 자산](/examples/glif-guide-project/gallery-lab/Resources/markdown-asset.svg "Markdown 자산")

## 표현과 투영

![같은 원문의 여러 보기](/examples/glif-guide-project/gallery-lab/Resources/projection-fan.svg "다양한 Projection")

![연결된 문서](/examples/glif-guide-project/gallery-lab/Resources/connected-notes.svg "연결과 참조")

재사용 경계

  • Markdown 이미지와 앨범 순서는 source가 소유한다.
  • Slide는 Gallery의 검색어, lightbox와 zoom 상태를 저장하지 않는다.
  • 렌더링할 수 없는 환경에는 읽을 수 있는 Markdown fence가 남는다.

Slide에서 결과 확인

Slide의 Gallery fence는 새로운 이미지 원본을 만드는 기능이 아니다. 현재 slide source 안에서 Gallery renderer를 재사용한다.

  1. 이 문서를 Slide 보기로 연다.
  2. 첫 slide에서 Gallery block의 이미지 순서와 alt text를 확인한다.
  3. 다음 slide로 이동해 본문과 이미지 경계가 분리되어 있는지 확인한다.
  4. Hugo 결과에서 slide navigation과 Gallery 카드가 지원 범위 안에서 materialize되는지 확인한다.
  5. Slide에서 바꾼 현재 slide 번호, zoom과 검색어가 source나 publish 결과에 복사되지 않는지 확인한다.

Slide 안에 Gallery block을 삽입한 Hugo 출력

Fence와 일반 Markdown의 관계

입력 Desktop Hugo
glif-view gallery fence Gallery projection candidate 지원 renderer가 있으면 static Gallery, 없으면 읽을 수 있는 fence
Markdown image Gallery 카드의 source 동일 이미지 경로를 사용하는 카드
slide 구분자 slide 순서와 경계 지원된 slide renderer의 정적 순서
검색·lightbox·현재 slide local session 게시 결과에 저장하지 않음

Fence 안의 이미지 경로가 깨졌다면 Slide 문제로 단정하지 않는다. 먼저 Gallery 단독 문서에서 같은 path가 보이는지 확인하고, 그 다음 fence의 닫힘·heading·Binder asset 범위를 확인한다.

최소 재현 source 

# Embed smoke

glif-view gallery
![대표 자산](/examples/glif-guide-project/gallery-lab/Resources/input-gate.svg)

첫 slide에 카드 하나가 보이면 embed parser와 asset path가 닫힌 것이다. 두 번째 카드와 heading을 추가한 뒤 slide 경계가 유지되는지 확인한다.

복구 순서

  • 빈 block: fence 이름과 닫힘 위치를 확인한다.
  • 일반 코드 블록으로 표시됨: 현재 Hugo renderer가 glif-view gallery를 지원하는지 확인한다.
  • 카드가 하나만 표시됨: Binder에 포함된 asset과 원문 이미지 경로를 대조한다.
  • slide가 합쳐짐: delimiter와 H1/H2 구조를 Source에서 확인한다.
  • Desktop과 Hugo의 카드 모양이 다름: interactive parity가 아닌 static materialization 경계로 기록한다.

완료 체크

  • Slide source와 Gallery source의 이미지 순서가 같다.
  • fence가 일반 Markdown으로 fallback되어도 원문을 읽을 수 있다.
  • asset 누락이 다른 이미지로 조용히 대체되지 않는다.
  • slide 번호·검색·lightbox 상태가 publish 결과에 남지 않는다.
  • 새 브라우저와 모바일 폭에서 카드와 slide가 넘치지 않는다.