생각의 정원을 만들고 배포하는 과정

공개 규칙과 원본

공개 대상은 설정한 폴더와 발행 상태로 결정한다. Obsidian 원본 노트 중 사이트 공개 기준을 통과한 것만 내보낸다.

회사 기술 블로그에 기고한 글은 이 사이트에 전문을 올리지 않고 제목·요약·원문 링크를 담은 소개 페이지로 전환한다.

노트 연결과 웹 탐색

Obsidian의 위키링크는 웹페이지 링크로 바뀌고, 참조·역참조와 생각 지도에도 사용한다. 노트에서 맺은 관계를 여러 탐색 방식에 활용한다.

빌드와 배포

사이트 저장소의 main에 코드를 push하거나 main으로 Pull Request를 열면 GitHub Actions가 Obsidian 저장소를 받아 타입 검사와 테스트를 거쳐 사이트를 엮고 생성된 결과를 검사한다. 문제가 없으면 GitHub Pages에 배포된다.

Obsidian 저장소만 수정해 push한 경우에는 다음 예약 빌드에 반영된다. 바로 반영하려면 사이트 저장소에서 배포 워크플로를 수동 실행한다.

공유 이미지 생성과 캐시는 정적 사이트의 OG 카드와 방문 통계에서 따로 다룬다.

작업 이력

• 2026.10.01 제보 링크와 폼 추가, Jev로 제보를 분류하는 GitHub Actions 워크플로 도입.
• 2026.09.20~23 화면 모드 수동 전환과 헤더·바닥글 개편.
• 2026.09.19 Obsidian 각주 지원, Playwright로 브라우저 회귀 검사 도입.
• 2026.09.14~17 Mermaid v12 의존성 전환, 코드 구문 강조, Markdown 파싱 구조와 Obsidian 문법 호환성 정비, 다크 모드와 dependabot 추가.
• 2026.09.12 TypeScript 적용, Node 26 전환, DESIGN.md 추가.
• 2026.09.09~10 사이트 코드 별도 저장소 분리, 공개 주소 루트 이전, 구조화 데이터와 llms.txt 추가.
• 2026.09.06 UI/UX 재검토, Astro 이관, 생각 지도 도입, 지도 상호작용·리더 내비게이션·OG·RSS·방문 통계 구현·배포.
• 2026.09.05 개인 위키 프로젝트 시작, Fable 5.1·GPT-6 Astra 성능 테스트, Obsidian 공개 노트와 글의 첫 정적 사이트 빌드 성공.