빠른 시작

첫 발행까지 다섯 단계면 충분합니다. 더 자세한 내용은 발행 워크플로에서 다룹니다.

#1. 공개할 노트에 표시하기

노트 맨 위 속성에 publish: true를 한 줄 추가합니다.

yaml

---
publish: true
---

이 속성이 없거나 false인 노트는 절대 발행되지 않습니다. 반대로 publish: true라도 사이트 설정의 제외 경로(예: 비공개/) 안에 있으면 발행되지 않습니다 — 제외가 항상 이깁니다.

#2. 발행 검토 돌리기

bash

npm run check

추가·변경·삭제될 문서와 첨부, 경고가 목록으로 나옵니다. 여기서 링크 오탈자와 비공개 참조를 먼저 고칩니다.

#3. 빌드와 미리보기

bash

npm run build     # site/ 에 정적 결과물 생성
npm run preview   # http://localhost:4173 에서 확인

#4. 배포

bash

npm run deploy

완성된 결과물이 서버의 새 release로 전송되고, 검증 후 현재 사이트가 한 번에 전환됩니다. 중간 상태가 방문자에게 보이는 일은 없습니다.

#5. 다시 쓰고, 다시 발행

노트를 고친 뒤 같은 절차를 반복하면 됩니다. 변경된 파일만 목록에 뜨고, 전체가 항상 일관되게 다시 만들어집니다.

자주 묻는 질문
Q. 노트를 지우면 사이트에서도 사라지나요?
네. 다음 발행 때 해당 문서와 검색·백링크·그래프 데이터, 참조가 없어진 첨부까지 함께 제거되고 이전 주소는 404를 반환합니다.
Q. 실수로 공개했다면?
publish 속성을 빼고 재발행하면 됩니다. 필요하면 직전 정상 배포로 되돌리는 롤백도 지원합니다.

연결된 문서

디지털 가든정원 글쓰기는 “공개”의 문턱을 낮춥니다. 발행은 회의록에 서명하는 일이 아니라, 밭에 씨앗 하나를 심는 일에 가깝습니다. 그래서 이 서비스는 두 가지를 약속합니다.

제텔카스텐더 읽을 거리: 이 사이트로 노트를 발행하는 방법.

링크와 임베드문서를 잇는 모든 방법을 한곳에 모았습니다. 링크는 항상 보라색+밑줄로 표시되고, 누를 수 없는 링크는 흐린 텍스트로 남습니다.

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

Second Brain에 오신 것을 환영합니다읽는 방법은 세 가지입니다.