문서에 맞는 보기 고르기

하고 싶은 일	원문 구조	추천 보기	이유
브리핑 한 장 만들기	H1 소개와 H2 section	Page	section을 카드 또는 accordion으로 읽음
상태 흐름 관리	H2 컬럼과 list/H3 카드	Kanban	카드 이동을 Markdown 순서에 반영
문서 구조 탐색	heading 계층	Hierarchy 또는 Mindmap	부모·자식 구조를 tree/node로 읽음
날짜 흐름 설명	날짜 또는 단계별 H2	Timeline	section을 시간·단계 흐름으로 표현
행과 열 편집	pipe table	Table	표 구조를 셀 중심으로 읽음
수치 비교	숫자 열이 있는 pipe table	Chart	table dataset에서 bounded chart 생성
일정과 진행률	ISO date table 또는 task heading	Gantt	기간과 진행 상태를 일정으로 표현
이미지 모음	Markdown 이미지가 있는 section	Gallery	source-derived media collection
계산 기록	Calc 문법과 결과 transcript	Calc	계산 결과를 정적 transcript로 게시
발표	H2 section 또는 delimiter deck	Slide	같은 Markdown을 slide sequence로 표현

선택 순서

1. 먼저 Source에서 문서가 사람이 읽을 수 있는지 확인한다.
2. 문서의 실제 구조를 찾는다. heading 계층인지, 보드인지, 표인지 구분한다.
3. 그 구조를 직접 읽는 보기를 고른다.
4. 빈 상태가 나오면 억지로 데이터를 채우기 전에 입력 구조를 다시 확인한다.
5. 보기에서 편집한 뒤 Source로 돌아가 원본 변화가 예상과 같은지 확인한다.
6. 게시할 문서라면 Hugo 결과와 Desktop 전용 상태를 구분한다.

하나의 문서에 모든 보기를 강요하지 않기

같은 Markdown이라도 구조가 맞지 않으면 projection은 의미 있는 결과를 만들 수 없다. 수치가 없는 문단 문서를 Chart로 열거나 heading 계층이 없는 파일을 Mindmap으로 여는 것은 좋은 활용 예가 아니다.

여러 목적이 있다면 원본을 무조건 복제하기보다, 목적이 다른 문서를 링크하거나 같은 source에서 지원되는 projection을 선택한다.

구조별 판별 질문

보기 선택기를 열기 전에 다음 세 질문에 답하면 빈 projection을 줄일 수 있다.

1. 원문에서 반복되는 단위는 무엇인가?
   • H2 아래의 카드와 본문이면 Page 또는 Slide를 먼저 고른다.
   • H2 아래의 task/list이면 Kanban을 고른다.
   • 날짜·단계가 각 section의 대표 값이면 Timeline 또는 Gantt를 고른다.
   • 행과 열이 반복되면 Table, 수치 비교가 목적이면 Chart를 고른다.
   • 이미지가 반복되면 Gallery, heading 부모 관계가 핵심이면 Mindmap을 고른다.
2. 보기에서 바꾼 결과를 원문에 저장해야 하는가?
   • 카드 이동, 셀 편집, node 이름 변경처럼 source-backed 조작이 필요한지 확인한다.
   • zoom, 검색, lightbox, filter만 필요하면 local session 상태로 취급한다.
3. 최종 독자가 보는 표면은 무엇인가?
   • Desktop에서만 검토할지, Hugo의 읽기 결과까지 배포할지 결정한다.
   • Hugo가 제공하지 않는 interaction은 별도 이미지·영상 또는 원문 표로 보완한다.

같은 source로 빠르게 비교하기

examples/glif-guide-project의 project-brief.md는 Page, project-board.md는 Kanban, project-roadmap.md는 Timeline, project-metrics.md는 Table·Chart, project-structure.md는 Mindmap을 위한 최소 fixture다.

1. 한 파일을 Source에서 먼저 연다.
2. 문서 헤더의 보기 선택기에서 추천 보기를 고른다.
3. 그림이나 카드가 비어 있으면 원문을 수정하기 전에 진단 문구와 입력 후보를 읽는다.
4. 두 번째 보기를 고를 때는 같은 파일의 byte와 heading·table 순서가 유지되는지 확인한다.
5. 공개할 경우 해당 보기의 상세 페이지에서 Desktop 캡처와 Hugo fallback 경계를 함께 확인한다.

실패를 빠르게 분류하기

증상	먼저 확인할 것	다음 조치
빈 projection	필요한 heading/table/date가 실제 Markdown에 있는가	구조를 맞추거나 다른 보기를 선택
일부만 표시	행·node·stage 제한과 빈 셀	원문을 나누고 제한을 초과하지 않게 조정
보기 설정이 사라짐	.glif 쓰기 권한과 profile binding	Scope 권한과 저장 상태를 확인
Hugo에서 동작하지 않음	Desktop 전용 session인지	원문 데이터·정적 fallback·설명으로 대체
다른 파일이 열림	저장된 source binding이 유효한가	Inspector에서 원본을 명시적으로 다시 선택

보기는 원문을 숨기는 마법이 아니라 같은 자산을 목적에 맞게 읽는 방식이다. 결과가 기대와 다르면 보기를 계속 바꾸기보다 입력 구조와 source binding부터 다시 확인한다.

선택 결과를 화면으로 대조

다음 세 캡처를 순서대로 보면 “구조에 맞는 보기”라는 선택 기준을 실제 결과와 연결할 수 있다.

결과가 비어 있으면 다른 보기로 무작정 바꾸지 말고, 원문 shape·필수 열·날짜·heading 구조와 상세 장의 진단 절을 먼저 확인한다.