시작 전 준비

필요한 것

  • Glif Desktop
  • 쓰기 가능한 로컬 폴더
  • 이 가이드의 pilot/fixture/ 폴더
  • 로컬 미리보기를 열 기본 웹 브라우저

예제 폴더 확인

fixture/에는 다음 Markdown이 있다.

fixture/
  _index.md
  project-brief.md
  project-board.md
  project-roadmap.md
  project-metrics.md
  project-structure.md

.glif/projections.json도 함께 들어 있지만 숨김 폴더를 일부러 편집할 필요는 없다. Glif에서 보기모드를 선택하면 이 파일이 문서별 기본 보기를 기억한다. Markdown front matter는 문서 제목, 설명과 정렬 같은 콘텐츠 metadata에 사용한다.

원본을 안전하게 유지하는 방법

처음 연습한다면 fixture를 별도 폴더로 복사한다. 이미 사용하는 문서 폴더에서 실습할 때는 다음을 확인한다.

  1. 중요한 파일의 백업이나 버전 관리가 있다.
  2. 폴더에 쓰기 권한이 있다.
  3. 동기화 프로그램이 충돌 파일을 만들고 있지 않다.

Glif는 로컬 파일을 직접 편집한다. “가져오기” 버튼을 누르지 않아도 Markdown 파일 자체가 원본이므로, 연습용 복사본을 사용하면 결과를 쉽게 되돌릴 수 있다.

다음

로컬 폴더를 Scope로 열기

준비 상태를 고정하는 체크

실습을 시작하기 전에 다음 값을 한 번 기록한다.

항목 확인 방법 성공 기준
Glif 버전 시작 화면 또는 설정의 버전 정보 가이드와 같은 release candidate
OS·배율 Windows 설정 캡처 환경과 동일하거나 차이를 기록
폴더 권한 Explorer에서 새 파일 만들기 Markdown 저장이 가능함
브라우저 기본 브라우저 설정 로컬 127.0.0.1 주소를 열 수 있음
fixture revision 폴더 복사 후 파일 목록·SHA-256 예제와 같은 파일을 사용함

권한이나 동기화가 의심되면 네트워크 드라이브에서 바로 시작하지 않는다. 먼저 로컬 임시 폴더에 fixture를 복사해 같은 절차를 재현한다.

복사 가능한 최소 fixture

전체 파일럿이 부담스럽다면 아래 두 파일만으로 Scope와 Preview를 먼저 연습할 수 있다.

project-brief.md

# Glif 파일럿 프로젝트

## 목적

Markdown 원문을 Glif에서 읽고 Hugo로 미리본다.

## 다음 단계

- [ ] Scope 열기
- [ ] 첫 문서 저장
- [ ] Preview 확인

_index.md

# 파일럿 안내

이 폴더는 로컬 원본과 생성 결과를 비교하는 연습용이다.

최소 fixture가 정상으로 열리면 나머지 project-board.md, project-roadmap.md, project-metrics.md, project-structure.md를 하나씩 추가한다. 파일을 모두 한 번에 추가하면 어느 문서의 구조나 asset이 실패를 일으켰는지 찾기 어렵다.

원본·생성물 경계

  • *.md와 함께 복사한 이미지·첨부 파일은 사용자가 소유한 원본이다.
  • .glif/는 보기 기본값과 profile 같은 앱 상태를 보관하는 보조 영역이다.
  • Hugo public/ 결과는 다시 편집할 원본이 아니다. 필요하면 Binder와 Markdown을 수정해 다시 생성한다.
  • 실습 중 발생한 diff는 저장 전에 확인하고, 의도하지 않은 파일 이동·삭제가 있으면 즉시 중단한다.

파일럿 fixture를 준비하고 Scope로 열기 전 확인할 화면

준비 완료 기준

  • fixture를 별도 복사본으로 만들었다.
  • 다섯 Markdown 파일과 _index.md가 존재한다.
  • .glif를 직접 편집하지 않고 Glif에서 Scope를 연다.
  • 파일 하나를 Explorer와 Glif 양쪽에서 읽을 수 있다.
  • Preview 실패 시 돌아올 원본 복사본이 있다.