발행 워크플로

이 서비스의 발행은 로컬에서 끝난 결과물을 통째로 전환하는 방식입니다. 서버는 정적 파일만 제공하고, 발행의 판단은 항상 작성자의 컴퓨터에서 일어납니다.

#파이프라인

text

Obsidian Vault
  → 공개 노트·첨부 선별        publish: true + 제외 경로 필터
  → 렌더링·검증                위키링크 해석, 임베드, 누출 검사
  → 미리보기                   localhost:4173
  → 배포                       새 release 디렉터리 전송
  → 원자적 전환                current 심볼릭 링크 교체

#공개 판정 순서

.obsidian, .git, 휴지통, 숨김 파일, 설정된 제외 경로를 먼저 뺀다.
남은 노트 중 publish: true인 것만 모은다.
공개 노트가 참조한 허용 첨부(png·jpg·webp·gif·pdf)만 함께 모은다.
모든 산출물(HTML·검색 인덱스·그래프·사이트맵)에 같은 공개 집합을 적용한다.

제외 경로는 항상 우선한다
비공개/ 폴더 안의 노트에 publish: true가 있어도 발행되지 않습니다. 실수로 속성을 붙이는 상황을 전제로 설계한 규칙입니다.

#발행 검토 보고서

npm run check와 npm run build는 같은 검토 보고서를 만듭니다.

변경 목록 — 마지막 배포 대비 추가·수정·삭제된 문서와 첨부
오류(차단) — 모호한 위키링크, 누락·비공개 임베드, 순환 임베드, URL 충돌, 잘못된 속성
경고(통과) — 비공개 문서로 향하는 링크, 지원하지 않는 문법, 큰 첨부

오류가 하나라도 있으면 배포는 중단됩니다. 기존 사이트는 그대로 유지됩니다.

#실패와 복구

상황	동작
빌드 오류	배포 중단, 기존 사이트 유지
전송 실패	새 release 폐기, 기존 사이트 유지
전환 후 문제	`npm run rollback`으로 직전 정상본 복구
공개 취소	속성 제거 후 재발행(전체 재생성이므로 잔존 없음)

서버에는 최근 정상 배포 5개를 webroot 밖에 보관합니다. 빠른 시작의 다섯 단계가 이 전체를 운전하는 손잡이입니다.

#파이프라인

#공개 판정 순서

#발행 검토 보고서

#실패와 복구

연결된 문서