문제 해결 & FAQ

문제 해결 & FAQ#

캘린더 검색 시 “연결 실패”#

증상: 연결 테스트 및 탐색을 클릭하면 “Harang calendar: Connection failed - …” 알림이 뜹니다.

원인: 대개 다음 중 하나입니다:

  • 서버 URL이 잘못됐거나, 접속할 수 없거나, https:// 스킴이 빠져 있습니다.

  • 사용자명이나 비밀번호가 틀렸습니다.

  • 서버가 표준 CalDAV 검색 절차(current-user-principal → calendar-home-set)를 지원하지 않고, 캘린더 컬렉션을 직접 가리키고 있지도 않습니다.

  • 서버가 Basic Auth가 아니라 OAuth2를 요구합니다 — Basic Auth만 지원합니다.

해결: 로그인 정보를 다시 확인하고, 검색이 계속 실패하면 서버 URL을 루트 대신 캘린더 컬렉션 URL로 직접 지정해보세요.

일정 칩이 흐릿하게 점선 테두리로 보임(“미해결”)#

증상: {{hrcal:...:event:...}} 칩이 일반 칩이 아니라 반투명에 점선 테두리로 표시되고, 클릭하면 “이 이벤트를 찾을 수 없습니다. 새로고침이 필요할 수 있습니다.”라고 나옵니다.

원인: 플러그인이 현재 캐시에서 일치하는 일정을 찾지 못했습니다. 참조된 일정이 서버에서 삭제됐거나, 속한 캘린더가 비활성화됐거나, 노트를 작성한 뒤로 로컬 캐시가 아직 새로고침되지 않았을 때 발생합니다.

해결: 캘린더 새로고침 명령을 실행하거나(또는 설정에서 새로고침 클릭) 노트를 다시 여세요. 새로고침 후에도 여전히 미해결이면, 그 일정이 서버에서 정말로 삭제됐거나(또는 그 캘린더가 비활성화된 것일 수 있으니 설정에서 이 캘린더 표시를 확인하세요).

반복 일정 시간이 DST(서머타임) 전환 시점 근처에서 한 시간 어긋나 보임#

원인: 내부적으로 쓰는 rrule 라이브러리가 UTC 달력 필드를 기준으로 반복 일정을 전개하기 때문에, 서머타임을 적용하는 시간대에서는 전환 시점을 지나면 반복 일정의 현지 시각이 서머타임 적용분만큼 어긋날 수 있습니다. 이는 현재 구현의 알려져 있고 받아들여진 제한사항입니다.

설치 후 플러그인이 보이지 않음#

해결: 설정 → 커뮤니티 플러그인에서 플러그인이 켜져 있는지 확인하세요(찾아보기로 설치해도 자동으로 켜지지는 않습니다), Obsidian이 1.13.4 이상인지도 확인하세요(사전 준비 참고). 수동으로 설치했다면 main.js, manifest.json, styles.css가 <vault>/.obsidian/plugins/harang-calendar/ 바로 안에 있는지(하위 폴더가 아니라) 확인하고, 파일을 복사한 뒤에는 Obsidian을 완전히 재시작하세요.

소스에서 설치한 경우#

아래 내용은 설치의 방법 3에 따라 플러그인을 직접 빌드한 경우에만 해당합니다 — 커뮤니티 플러그인으로 설치한 대부분의 사용자는 겪을 일이 없습니다.

증상: 최신 소스 변경사항을 pull했는데, Obsidian은 여전히 예전 버전처럼 동작합니다.

원인: 소스에서 설치하려면 명시적인 재빌드와 수동 복사 단계가 필요합니다 — 새 소스를 pull하는 것만으로는 Obsidian이 실제로 불러오는 파일이 갱신되지 않습니다.

해결: 전체 업데이트 절차를 실행하세요:

git pull
npm install
npm run build

그런 다음 새로 빌드된 main.js를(manifest.json/styles.css가 바뀌었다면 그것도) <vault>/.obsidian/plugins/harang-calendar/로 다시 복사하고, Obsidian을 재시작하세요.