보기모드 기능 비교표
| 보기 | 주 입력 | Desktop의 대표 작업 | Hugo 결과 | 주요 경계 |
|---|---|---|---|---|
| Page | H1과 H2 section | 카드 내용·순서·task 편집, style 설정 | Markdown-derived Page | 모든 visual 조합의 픽셀 parity는 아님 |
| Hierarchy | heading과 bullet 계층 | 계층 탐색·지원되는 구조 편집 | 계층 renderer | 별도 outline database가 아님 |
| Mindmap | heading 계층 | node rename/add/reparent, zoom·검색 | heading 기반 map | 저장 그룹·관계선은 publish 비대상 |
| Kanban | H2와 list/H3 카드 | 카드·컬럼 편집과 이동, filter | 읽기용 board | filter·drag session state는 비대상 |
| Timeline | 날짜/단계 H2와 body | entry 편집·이동, task toggle | source-derived timeline | session 선택 상태는 비대상 |
| Table | Markdown pipe table | 셀·행·열 편집과 일부 overlay | 정적 table projection | freeze/hidden/saved view는 Desktop 상태 |
| Chart | Markdown table | 축·series와 제한된 style 설정 | bounded static chart | copied dataset·renderer 세부 옵션 비대상 |
| Gantt | task heading 또는 ISO-date table | 일정 읽기·지원 편집·snapshot | source-derived Gantt | Desktop interaction 전체를 전달하지 않음 |
| Calc | 계산 source와 managed result | 계산 실행·결과 반영 | 정적 transcript | Hugo/browser가 계산하지 않음 |
| Gallery | section과 이미지 | 검색·lightbox·style | source-derived gallery | diagnostics/search/session state 비대상 |
| Slide | H2 section 또는 delimiter | slide 편집·탐색·재생 | Glif slide renderer | 별도 Marp iframe을 공개 계약으로 두지 않음 |
표 읽는 법
“Hugo 결과 있음”은 Desktop의 모든 control이 웹에서도 동작한다는 뜻이 아니다. publish는 같은 Markdown과 지원되는 projection metadata를 사용해 읽기 결과를 materialize한다.
전체 보기에서 공통으로 지킬 것
- Markdown 원본을 숨은 renderer 데이터로 대체하지 않는다.
- 보기 선택은 front matter
viewType에 저장하지 않는다. - 지원하지 않는 source shape는 빈 상태나 진단으로 드러낸다.
- Desktop 편집과 Hugo 읽기 결과를 같은 capability로 표현하지 않는다.
- 저장되지 않은 session 상태를 publish된 문서의 사실처럼 만들지 않는다.
보기별 실습 순서
표의 한 줄은 “지원한다”는 선언이 아니라 source·Desktop·Hugo의 서로 다른 계약을 요약한다. 아래 순서로 각 행을 실제 fixture에 대조한다.
- 입력 확인: Source에서 필요한 heading, task, 날짜, pipe table, 이미지 또는 계산 transcript가 있는지 확인한다.
- 보기 전환: 문서 헤더의 보기 선택기에서 한 번만 전환하고, 빈 상태·진단·후보 원본을 읽는다.
- source-backed 조작 구분: 값·순서·구조가 Markdown에 저장되는 조작과 zoom·검색·filter 같은 session 조작을 나눈다.
- profile 확인: 표현 설정은
.glif/profiles/v1/by-path-sha256/에 저장되는 지원 필드만 확인한다. 원문 행이나 canvas payload가 profile에 복사되지 않는지 확인한다. - publish 확인: Hugo 로컬 미리보기에서 같은 source가 정적 결과로 materialize되는지, Desktop 전용 상태가 설명이나 접근 가능한 fallback으로 대체되는지 확인한다.
입력 shape와 결과 판정
| 결과 | 의미 | 기록할 위치 |
|---|---|---|
| 정상 projection | required shape와 값이 유효하고 결과가 source와 일치 | 해당 장의 성공 경로와 evidence manifest |
| 빈 상태 | 입력 후보가 없거나 구조가 부족함 | 원문 수정 전 진단 캡처 |
| unresolved | 저장된 source binding이 사라지거나 모호함 | Inspector의 원본 선택 상태 |
| fail-closed | cycle, invalid number, 행·node 제한 초과처럼 부분 결과를 내면 안 됨 | 오류 예제와 복구 절차 |
| publish fallback | Hugo가 interactive renderer를 재현하지 않음 | Desktop·Hugo parity 절의 명시적 경계 |
이 표에서 다루지 않는 것
- 표의 “대표 작업”은 모든 단축키·마우스 조합의 목록이 아니다. 실제 조작은 각 보기의 상세 장과 동영상에서 검증한다.
- Hugo 결과 열은 브라우저에서 Desktop canvas를 다시 실행한다는 뜻이 아니다.
- 저장 상태와 profile 키는 앱 버전에 따라 추가될 수 있으므로, Markdown front matter에 구현 세부를 복사해 계약으로 만들지 않는다.
- 지원되지 않는 입력을 자동으로 다른 보기로 변환하거나 첫 번째 표에 조용히 붙이는 fallback은 정상 결과로 취급하지 않는다.
학습 경로
처음에는 문서에 맞는 보기 고르기에서 입력 구조를 판별한 뒤, Table과 Chart, Timeline, Diagram 중 하나의 상세 장을 끝까지 실습한다. 마지막으로 Desktop과 Hugo 결과 비교에서 publish 경계를 확인한다.
대표 결과를 비교하는 캡처
표의 capability를 실제 화면과 함께 읽으면 Desktop 작업과 Hugo 결과의 차이를 놓치지 않는다.
상세 입력 문법·저장·오류·영상은 각 보기 장에서 확인한다. 이 표의 한 행만 보고 지원하지 않는 interaction이나 pixel parity를 추론하지 않는다.