설치#
먼저 사전 준비 사항의 절차를 완료했는지 확인하세요.
harang-nextcloud는 Obsidian 공식 커뮤니티 플러그인 목록에 등록되어 있으므로, Obsidian 안에서 바로 설치하는 것이 권장되는 방법입니다.
방법 1 — 커뮤니티 플러그인 찾아보기 (권장)#
Obsidian에서 설정 → 커뮤니티 플러그인을 여세요.
찾아보기를 클릭한 뒤 “Harang Nextcloud”를 검색하세요.
설치를 클릭한 뒤 활성화하세요.
이후 업데이트가 있을 때도 Obsidian이 알려주며, 같은 화면에서 플러그인을 업데이트할 수 있습니다.
방법 2 — 미리 빌드된 파일로 수동 설치#
이미 빌드된 플러그인 파일(main.js, manifest.json, styles.css) — 예를 들어 릴리스 아카이브에서 얻은 파일 — 을 가지고 있고, 커뮤니티 플러그인 찾아보기를 거치지 않고 설치하고 싶다면 이 방법을 사용하세요.
볼트 안에
<vault>/.obsidian/plugins/harang-nextcloud/폴더가 없다면 만드세요.main.js,manifest.json,styles.css를 그 폴더에 복사하세요.Obsidian을 재시작한 뒤 설정 → 커뮤니티 플러그인에서 Harang Nextcloud를 활성화하세요.
방법 3 — Git 저장소를 클론해서 소스에서 빌드#
특정 커밋에서 빌드하거나 플러그인 개발에 기여하려면 이 방법을 사용하세요.
요구 사항: Node.js 18 이상.
git clone https://github.com/search5/harang-nextcloud.git
cd harang-nextcloud
npm install
npm run build
프로젝트 루트에 main.js가 생성됩니다. 방법 2에서 설명한 대로 이 파일을 manifest.json, styles.css와 함께 <vault>/.obsidian/plugins/harang-nextcloud/에 복사한 뒤 Obsidian을 재시작하고 플러그인을 활성화하세요.
참고
npm run dev는 esbuild를 감시(watch) 모드로 실행해 소스가 바뀔 때마다 main.js를 다시 빌드합니다 — 플러그인 자체를 계속 수정할 때 유용합니다.
설치를 마쳤다면 사용법로 이어서 Nextcloud 서버 프로필을 연결하세요.