사용법#
CardDAV 서버 프로필 추가하기#
설정 → Harang Contacts를 여세요.
CardDAV 서버 추가를 클릭하세요.
프로필 정보를 입력하세요:
필드 |
설명 |
|---|---|
프로필 이름 |
이 서버를 가리키는 라벨로, 여러 서버에 걸쳐 연락처 이름이 겹칠 때 함께 표시됩니다. |
서버 URL |
CardDAV 기본 URL 또는 정확한 주소록 컬렉션 URL입니다. |
사용자명 / 비밀번호 |
CardDAV 계정 자격 증명입니다. |
연결 테스트 및 자동탐색을 클릭하세요. 플러그인이 표준 CardDAV 탐색 절차(
current-user-principal→addressbook-home-set→ 주소록 컬렉션)를 따라가며 찾아낸 주소록 URL을 자동으로 채웁니다. Server URL이 이미 주소록 컬렉션을 직접 가리키고 있다면, 추가 탐색 없이 그대로 사용됩니다.
여러 프로필을 추가할 수 있으며(여러 서버, 또는 같은 서버의 여러 주소록), 모든 프로필의 연락처가 합쳐져 사용됩니다.
노트에서 연락처 참조하기#
{{hrcard:를 입력해 단계별 참조를 시작하세요:
Meeting notes with {{hrcard:
등록된 서버 프로필 이름 목록이 자동완성 팝업으로 나타나며, 입력에 따라 범위가 좁혀집니다. 하나를 선택하면
<profileId>:— 검색에 쓴 이름이 아니라 프로필의 내부 id — 가 이어붙여지고, 바로 다음 단계가 열립니다.이제 팝업은 그 프로필의 연락처를 이름순으로 보여주며(대소문자를 구분하지 않는 부분 문자열 검색), 각 후보의 조직명과 이메일을 힌트로 함께 표시합니다.
연락처를 선택하면 {{hrcard:<profileId>:<uid>}}가 삽입되고, 둥근 알약 모양의 칩 — 연락처 이름과(있다면) 이메일 주소 — 으로 표시됩니다. 라이브 프리뷰와 읽기 모드 모두 동일하게 동작합니다.
참고
삽입되는 문법은 표시 이름이 아니라 서버 프로필의 내부 id와 CardDAV UID를 저장하므로, 다른 연락처가 우연히 같은 이름을 갖고 있더라도, 나중에 그 연락처의 이름이 서버에서 바뀌더라도, 심지어 설정에서 프로필 자체의 이름을 바꾸더라도 칩은 항상 당신이 선택한 바로 그 연락처를 정확히 가리킵니다. 이 id 기반 방식은 이 변경 이후로 삽입되는 참조에만 적용됩니다: 이 동작이 바뀌기 전에 삽입된 참조는 id 대신 프로필의 이름을 저장하고 있었으므로, 그런 예전 참조는 여전히 프로필 이름을 바꾸면 깨집니다. 둘 사이에는 대체 해석 경로가 없습니다 — 더 이상 해석되지 않는 예전 참조는 {{hrcard: 자동완성으로 삭제 후 다시 삽입해야 합니다.
연락처 상세 정보 보기#
칩을 클릭하면 연락처의 이메일, 전화번호, 조직(CardDAV 레코드에 있는 필드만) 정보를 담은 작은 카드가 열립니다. 카드 바깥을 클릭하거나 Esc를 누르면 닫힙니다.
칩이 흐릿하게 표시되고 점선 테두리가 보인다면, 플러그인이 그 참조를 알려진 연락처로 해석하지 못한 것입니다 — 대부분 주소록 캐시가 오래됐기 때문입니다. 문제 해결 & 자주 묻는 질문을 참고하세요.
주소록 캐시 새로고침하기#
연락처는 캐시되며, 설정에서 정한 캐시 유효 시간(기본 30분)이 지나면 자동으로 새로고침됩니다. 즉시 새로고침하려면:
명령 팔레트에서 주소록 새로고침 명령을 실행하거나,
설정에서 지금 모든 주소록 새로고침 옆의 새로고침을 클릭하세요.