Glif 상세 가이드
Glif는 로컬 폴더의 Markdown을 원본으로 유지하면서 같은 문서를 작성 화면, Kanban, Page, Mindmap과 웹사이트로 다르게 활용하는 문서 작업 공간이다. 이 매뉴얼은 기능 이름만 나열하지 않는다. 실제 예제 프로젝트를 열고, 원문을 편집하고, 목적에 맞는 보기로 전환하고, 결과를 Hugo 사이트에서 확인하는 순서로 설명한다.
처음 사용하는 사람은 위에서 아래로 따라가고, 이미 익숙한 사람은 필요한 기능의 상세 페이지와 문제 해결 절만 골라 읽을 수 있다. 모든 조작형 기능은 가능한 경우 실제 Glif Desktop 이미지나 영상과 함께 설명하며, 예제 원문도 사이트에 포함한다.
문서는 자산이다
Glif에서 문서는 한 번 읽고 버리는 결과물이 아니다. 사용자가 소유한 Markdown 원본과 에셋을 계속 연결하고, 다른 작업면으로 보고, 여러 결과로 내보내고, 가치 있는 파생물을 다시 입력으로 가져오면서 수명이 늘어나는 자산이다.
- 소유권: 로컬 파일과 사용자가 선택한 저장소가 기준이다.
- 다양성: Markdown뿐 아니라 문서, 표, 이미지, 오디오, URL과 외부 source를 함께 다룬다.
- 하나의 원본: 보기마다 복사본을 만들지 않고 같은 Markdown을 목적에 맞게 projection한다.
- 재사용: link, embed, reference, Cart와 조립 surface로 기존 내용을 다시 쓴다.
- 다양한 출력: 문서 파일, package, PWA와 웹사이트로 결과를 만든다.
- 신뢰: 저장·충돌·history·preflight와 복구 경로를 결과만큼 중요하게 다룬다.
LLM Wiki 관점: 소유한 지식의 재발견
Glif는 LLM Wiki 자체를 대신하려는 제품이 아니다. 대신 같은 문제의식—흩어진 지식을 구조화하고 다시 찾게 하는 일—을 사용자가 소유한 Markdown 자산과 연결해 구현한다. 입력 Gate에서 문서를 Markdown 중심 자산으로 정리하고, heading·metadata·link·relation을 보존한 뒤, Author Search와 공개 출력의 검색 표면으로 다시 투영한다.
Knowledge Search v1은 이 철학을 보여 주는 대표 기능이다. 작성자는 원문과 관계를 확인하고, 독자는 Hugo/PWA에 게시된 공개 문서에서 같은 질문형 검색 경험을 얻는다. 검색어는 외부로 전송하지 않으며, 생성 답변·embedding·온디바이스 AI 없이 bounded snapshot과 명시적인 공개 범위만 사용한다. 현재 구현과 자동 증빙은 준비되었고, 실제 공개 승격은 사람 검수와 release gate를 통과한 뒤 결정한다. 검색·링크·지식 관리와 Author Search·Public Lens 로드맵에서 현재 기능과 다음 공개 단계를 구분해 볼 수 있다.
flowchart LR
subgraph IN["다양한 입력"]
I1["Markdown·폴더"]
I2["문서·표·PDF"]
I3["이미지·오디오·URL"]
end
G["Input Gate"]
C["Markdown 중심 자산"]
U["연결·참조·투영·조립"]
O["Output Gate"]
subgraph OUT["다양한 결과"]
O1["PDF·DOCX·EPUB"]
O2["Web·PWA·package"]
O3["번역·오디오·새 에셋"]
end
I1 --> G
I2 --> G
I3 --> G
G --> C --> U --> O
O --> O1
O --> O2
O --> O3
O3 -. "명시적으로 다시 가져오기" .-> GInput Gate는 모든 파일을 강제 변환하지 않는다. 원본을 먼저 미리보고 필요한 경우에만 Markdown이나 관리 가능한 에셋으로 승격한다. Output Gate도 단순 저장 버튼이 아니라 범위·형식·권한·provider·preflight·결과 확인을 함께 다룬다. 출력물은 자동으로 새 원본이 되지 않으며, 다시 사용할 가치가 있는 결과만 사용자가 명시적으로 가져온다.
Glif의 10개 기능군
| 기능군 | 할 수 있는 일 | 대표 장 |
|---|---|---|
| 모으기 | 폴더, 문서, 웹과 에셋을 작업 원천으로 만든다 | 설치와 시작, 문서·파일과 가져오기 |
| 쓰기 | Markdown과 구조를 안전하게 편집한다 | Markdown 작성과 에디터 |
| 연결하기 | link, embed, 검색과 graph로 관계를 만든다 | 검색, 링크와 지식 관리 |
| 구조화하기 | metadata, 표, 수식과 query로 다시 묶는다 | Markdown 표와 데이터 작업 |
| 다르게 보기 | Page, Kanban, Mindmap, Timeline 등으로 투영한다 | 문서 보기와 Projection |
| 조립하기 | Cart, Canvas와 Desk에서 기존 재료를 재구성한다 | Cart, Canvas와 Desk 조립 |
| 내보내기 | PDF·DOCX·EPUB·package를 만든다 | 문서 출력과 출판 워크벤치 |
| 게시하기 | Hugo site, PWA와 배포 결과를 운영한다 | 웹 미리보기, 게시와 배포 |
| 번역하고 듣기 | 번역·glossary·review와 문서 오디오를 만든다 | AI 제안, 번역과 오디오 |
| 맞추고 확장하기 | 설정, theme, 계정, provider와 접근성을 조정한다 | 계정·Provider·플랜, 설정·테마·접근성 |
이 기능군은 현재 버튼의 개수만 세는 목록이 아니라 출시 목표를 설명하는 제품 architecture다. 일부 지원 기능은 검증된 범위와 남은 gate를 함께 표시하고, deferred 기능은 현재 절차처럼 쓰지 않는다.
전체 15장
| 장 | 내용 | 시작점 |
|---|---|---|
| 10 | 설치와 시작하기 | 첫 로컬 프로젝트 |
| 20 | 작업 공간과 탐색 | Scope·Shelf·launcher |
| 30 | 문서, 파일과 가져오기 | preview와 승격 |
| 40 | Markdown 작성과 에디터 | 구조 편집과 저장 |
| 50 | 검색, 링크와 지식 관리 | 검색·참조·graph |
| 60 | Markdown 표와 데이터 작업 | 표·수식·차트 |
| 70 | 문서 보기와 Projection | 보기 선택과 source 경계 |
| 80 | Cart, Canvas와 Desk 조립 | 재료 모으기와 조립 |
| 90 | 문서 출력과 출판 워크벤치 | 다중 output |
| 100 | 웹 미리보기, 게시와 배포 | Hugo·설정·deploy |
| 110 | 계정, Provider와 플랜 | identity·연결·소유권 |
| 120 | 설정, 테마와 접근성 | 환경 조정과 복구 |
| 130 | AI 제안, 번역과 오디오 | 검토 가능한 파생 작업 |
| 140 | 히스토리, 복구와 문제 해결 | 충돌·diff·rollback |
| 150 | 레퍼런스와 전체 예제 | 샘플 source와 lookup |
지금 공개된 학습 경로
1. 내 폴더에서 첫 프로젝트 시작하기
로컬 폴더를 Scope로 열고 현재 작업 범위와 Binder를 구분한다. 첫 Markdown 문서를 연 뒤 Glif가 만든 Hugo 로컬 사이트를 브라우저에서 확인한다.
2. 같은 Markdown을 Kanban으로 활용하기
Markdown heading과 task가 Kanban의 컬럼과 카드가 되는 규칙을 익힌다. 카드를 옮긴 뒤 원문이 어떻게 달라지는지 확인하고, 같은 문서를 읽기용 Kanban 사이트로 만든다.
3. 보기모드와 Projection 이해하기
보기모드가 원본 파일의 복사본이 아니라 Markdown을 목적에 맞게 해석한 projection이라는 점을 이해한다. Page, Kanban, Mindmap의 입력 구조·편집 범위·Hugo 결과를 비교한다.
4. 설치 없이 Web Edition 첫 성공 만들기
Web Edition에서는 sample Binder의 같은 Markdown 원문을 확인한 뒤 Page·Kanban·Timeline 등 지원되는 projection으로 전환한다. 이 경로는 데스크톱 설치나 계정 없이 제품의 핵심 모델을 확인하는 공개 체험이며, 브라우저 Local Scope와 local output으로 확장할 수 있다.
빠른 시작 권장 순서
화면을 먼저 보며 시작하고 싶다면 화면과 영상으로 따라 하는 실습 경로에서 같은 예제의 실제 Desktop·Hugo 캡처를 본 뒤 아래 순서로 진행한다. 이 동반 경로에는 시작, 조립, Kanban, 링크, Chart, 사이트 설정, 복구의 정적 이미지와 영상을 함께 모아 두었다.
| 순서 | 챕터 | 예상 시간 | 결과 |
|---|---|---|---|
| 0 | 화면·영상 실습 경로 | 20분 | 실제 화면을 보며 전체 원본→결과 흐름 파악 |
| 1 | 첫 프로젝트 | 15분 | Scope와 Binder, 첫 로컬 사이트 |
| 2 | Markdown Kanban | 20분 | source-backed 보드와 게시 결과 |
| 3 | 보기모드 레퍼런스 | 25분 | 문서 구조에 맞는 보기 선택 기준 |
| 4 | Web Edition 첫 성공 | 5분 | 같은 원문의 source 확인과 projection 전환 |
전체 기능을 끝까지 검증하는 경로
빠른 시작 뒤에는 아래 순서로 같은 자산을 입력·편집·투영·출판까지 통과시킨다. 각 행의 예제는 복사해 별도 Scope에서 실행할 수 있고, 상세 장의 이미지·영상은 실제 Desktop 조작과 Hugo 결과를 함께 보여 준다.
| 단계 | 직접 해 볼 것 | 대표 예제·상세 장 | 확인할 결과 |
|---|---|---|---|
| 1 | Scope·Shelf·Binder를 만들고 폴더를 연다 | 작업 공간과 탐색 | 범위와 파일 소유권이 분리됨 |
| 2 | Markdown 문서를 만들고 link·embed를 추가한다 | Markdown 작성과 에디터, 검색·링크 | 원문 diff와 링크 대상이 확인됨 |
| 3 | 표·수식·query를 작성한다 | Markdown 표와 데이터 | 셀, 계산 결과, query 경계가 보임 |
| 4 | 같은 문서를 Page·Kanban·Mindmap으로 바꾼다 | 문서 보기와 Projection | 보기 변경과 source 변경을 구분함 |
| 5 | Timeline·Chart·Diagram을 원문으로 검증한다 | Timeline, Chart, Diagram | source, profile, session 상태가 분리됨 |
| 6 | Gallery·Slide·Blueprint로 재조립한다 | Gallery, Slide, Blueprint | 이미지·발표·캔버스 결과가 원문을 대체하지 않음 |
| 7 | Cart·Canvas·Desk와 Binder를 조립한다 | Cart, Canvas와 Desk | 선택한 재료와 저장 원본의 경계가 보임 |
| 8 | PDF·DOCX·EPUB·package를 출력한다 | 문서 출력과 출판 워크벤치 | preflight와 실패한 output을 구분함 |
| 9 | Hugo 설정·preview·deploy를 확인한다 | 웹 미리보기, 게시와 배포 | provider와 local fallback을 혼동하지 않음 |
| 10 | 계정·설정·번역·오디오·복구를 점검한다 | 계정·Provider, 설정·접근성, 번역·오디오, 복구 | 권한·runtime·partial gate와 복구 경로를 기록함 |
Web Edition 동반 경로
15장 데스크톱 매뉴얼과 별개로, 메인에 추가된 glif-web 공개 표면은 짧은 동반 경로로 제공한다. Web Edition 상세 페이지와 Projection 실습표는 first-success, browser-local 저장·가져오기, projection parity와 native/provider 경계를 한 곳에서 확인하게 한다. 구현 세부와 전체 projection 목록은 Playground와 Markdown Projection 레퍼런스를 함께 참조한다.
각 단계는 “화면이 보였다”로 끝내지 않는다. 원문 저장, 재실행 복원, 실패 시 fail-closed, Hugo 결과와의 차이 중 해당되는 검증을 체크하고 evidence manifest의 시나리오와 대조한다.
4. 예제 프로젝트 원문
가이드에서 사용하는 Markdown 원문과 projection profile을 그대로 확인하거나 내려받는다. 예제를 복사해 자신의 Scope에서 열 수 있다.
공용 예제 프로젝트
현재 공개된 절차는 /examples/glif-guide-project/에 포함된 공용 프로젝트를 사용한다. 예제에는 같은 프로젝트를 서로 다르게 표현하기 위한 문서가 들어 있다.
project-brief.md: Pageproject-board.md: Kanbanproject-roadmap.md: Timelineproject-metrics.md: Table과 Chartproject-structure.md: Mindmap
보기 선택은 각 문서의 front matter가 아니라 fixture의 .glif/projections.json에 저장된다. Markdown 파일만 다른 도구에서 열어도 본문은 그대로 읽을 수 있다.
이미지와 영상 읽는 법
- 이미지는 실제 Glif Desktop의 client area 또는 실제 Hugo 결과만 잘라 사용한다.
- 영상은 WebM을 우선 재생하고 MP4를 fallback으로 제공한다.
- 노란 강조는 클릭 대상이나 조작 결과를 설명하기 위한 가이드 표시다.
- 영상이 재생되지 않아도 같은 결과를 만드는 텍스트 절차를 바로 아래에서 확인할 수 있다.
- fixture hash, 캡처 환경, 기능 ID와 판정은 공개 evidence manifest에서 확인할 수 있다.
지원 범위 읽는 법
- 편집 가능: 보기에서 한 조작이 지원되는 Markdown 변경으로 저장된다.
- 로컬 보기 상태: 검색, 확대·축소처럼 원문을 바꾸지 않는 상태다.
- Hugo에 반영: Glif가 만든 publish copy에서 읽기용 결과로 materialize된다.
- Desktop 전용: 로컬 앱에서만 제공되며 웹 결과에는 전달되지 않는다.
현재 첫 학습 경로는 로컬 미리보기까지 검증되어 있다. 외부 provider와 production 게시처럼 별도 자격 증명이 필요한 기능은 해당 장에서 준비 상태와 검증 범위를 명확히 구분한다.