설치

설치#

사전 준비 사항의 단계를 먼저 완료했는지 확인하세요.

harang-contacts는 Obsidian 공식 커뮤니티 플러그인 목록에 등록되어 있으므로, Obsidian 안에서 바로 설치하는 것이 권장되는 방법입니다.

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

이미 빌드된 플러그인 사본(main.js, manifest.json, styles.css)이 있다면 이 방법을 사용하세요 — 예를 들어 릴리스 압축 파일로 받았거나, 커뮤니티 플러그인 찾아보기를 거치지 않고 설치하고 싶은 경우입니다.

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

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

  3. Obsidian을 재시작한 뒤, 설정 → 커뮤니티 플러그인에서 Harang Contacts를 활성화하세요.

방법 3 — Git 저장소를 복제해 소스에서 직접 빌드#

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

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

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

이 명령은 프로젝트 루트에 main.js를 생성합니다. 이 파일을 manifest.json, styles.css와 함께 방법 2에서 설명한 대로 <vault>/.obsidian/plugins/harang-contacts/에 복사한 뒤, Obsidian을 재시작하고 플러그인을 활성화하세요.

참고

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

설치가 끝났다면 사용법로 이동해 CardDAV 서버 프로필을 설정하세요.