설치#

사전 준비의 단계를 먼저 완료하세요.

harang-calendar는 Obsidian 커뮤니티 플러그인 디렉터리에 등록되어 있으므로, 대부분의 사용자는 아래 방법 1을 사용하면 됩니다. 수동 설치(방법 2, 3)는 그 방식을 선호하거나 특정 사전 릴리스 빌드를 설치하고 싶은 사용자를 위해 계속 제공됩니다.

방법 2 — 빌드된 파일 수동 설치#

플러그인의 빌드된 사본(main.js, manifest.json, styles.css)이 이미 있고, 커뮤니티 플러그인 화면을 거치고 싶지 않은 경우 이 방법을 사용하세요 — 예를 들어 릴리스 아카이브에서 받은 경우.

  1. 보관소(vault)에 <vault>/.obsidian/plugins/harang-calendar/ 폴더가 없다면 만드세요.

  2. main.js, manifest.json, styles.css를 그 폴더로 복사하세요.

  3. Obsidian을 재시작한 뒤 설정 → 커뮤니티 플러그인에서 Harang Calendar를 켜세요.

방법 3 — Git 저장소를 클론해서 소스에서 빌드#

특정 커밋에서 빌드하거나 플러그인 개발에 기여하고 싶다면 이 방법을 사용하세요.

요구사항: Node.js 18 이상.

git clone https://github.com/search5/harang-calendar.git
cd harang-calendar
npm install
npm run build

프로젝트 루트에 main.js가 생성됩니다. 이를 manifest.json, styles.css와 함께 방법 2에서 설명한 것처럼 <vault>/.obsidian/plugins/harang-calendar/로 복사한 뒤, Obsidian을 재시작하고 플러그인을 켜세요.

참고

npm run dev는 esbuild를 watch 모드로 실행해 소스가 바뀔 때마다 main.js를 다시 빌드합니다 — 플러그인 자체를 수정할 때 유용합니다.

설치가 끝나면 사용법로 이어가서 CalDAV 계정을 설정하세요.