사용법

여러 볼트 연결

연구 노트 볼트, 강의 볼트, 팀 볼트처럼 볼트가 여럿이어도 같은 논문을 다룬 노트를 한 번에 찾을 수 있습니다. 볼트를 합치지 않고, 서로 읽기만 합니다.

무엇을 하나

Find literature across vaults에서 문헌을 고르면, 이 볼트와 등록한 다른 볼트에서 그 문헌을 다룬 노트를 모두 나열하고 클릭 한 번으로 엽니다. 다른 볼트에는 아무것도 쓰지 않습니다.

어떻게 동작하나

각 볼트의 CMDS Zotero는 인덱스를 갱신하거나 문헌 노트가 바뀔 때, 자기 볼트의 문헌 노트 위치를 노트 지도(.cmds-zotero/note-map.json)에 적어 둡니다. 지도는 citekey가 아니라 Zotero 항목 식별로 노트를 묶습니다. 다른 볼트의 플러그인은 이 지도만 읽습니다.

flowchart LR
  Z["같은 Zotero 서재"] --> A1["볼트 A의 CMDS Zotero"]
  Z --> B1["볼트 B의 CMDS Zotero"]
  B1 -->|"인덱스 갱신 때"| B2["볼트 B의 노트 지도"]
  A1 -.->|"읽기만"| B2
  A1 --> R["Find literature across vaults"]
  R --> O["볼트 B의 노트 열기"]
  %% @key: R
  %% @aux: Z
볼트는 서로의 노트를 열어 보지 않고, 각자 공개한 지도만 읽습니다.

설정 순서

  1. 연결할 각 볼트에 CMDS Zotero를 설치하고, 같은 컴퓨터의 같은 Zotero에 연결합니다.
  2. 각 볼트에서 Refresh citekey index를 한 번 실행합니다. 이때 그 볼트의 노트 지도가 만들어집니다.
  3. 찾기를 할 볼트의 설정 → Connected vaults → Peer vaults에 한 줄에 하나씩 적고 Save configuration을 누릅니다.
LLM Wiki | /Users/me/Obsidian/LLM Wiki
Team Research | /Users/me/Obsidian/Team Research
  1. Diagnose setup을 실행하면 등록한 볼트마다 지도를 읽을 수 있는지 보여 줍니다.
  2. 양쪽에서 찾고 싶다면 상대 볼트에도 이 볼트를 등록합니다. 연결은 한 방향씩입니다.

주의할 것

확인할 것 이유
줄의 볼트 이름이 그 볼트의 실제 이름과 똑같은가 지도에는 자기 볼트 이름이 적혀 있고, 이름이 다르면 읽지 않습니다. 볼트 이름은 볼트 폴더 이름입니다
경로가 절대 경로인가 ~/나 상대 경로는 받지 않습니다
상대 볼트에서 인덱스를 한 번 갱신했나 지도가 없으면 "Refresh the index in the registered vault"라고 알립니다
같은 Zotero 서재인가 노트는 Zotero의 로컬 라이브러리 ID와 item key로 맞춥니다. 다른 컴퓨터의 Zotero나 다른 서재의 같은 논문은 다른 항목입니다
노트를 새로 가져온 뒤인가 새 노트는 그 볼트의 지도가 다시 쓰인 뒤에 보입니다

열리는 주소는 기본 obsidian://open?vault=…&file=…이고, 상대 볼트에 Advanced URI 플러그인이 켜져 있으면 그 형식을 씁니다. 지도가 상대 볼트 밖을 가리키거나 4MB를 넘으면 읽지 않습니다.

링크 복사 명령

문헌 노트를 다른 앱(메일, 할 일 앱, Hookmark)에서 가리키고 싶을 때 씁니다.

명령 복사되는 것
Copy Zotero item link (Hookmark-compatible) Zotero 항목을 여는 Markdown 링크
Copy literature note identity link (rename-safe) 노트 이름을 바꿔도 같은 노트를 여는 obsidian://cmds-zotero 링크
Copy Obsidian file link (Hookmark-native) 문헌 노트의 obsidian://open 주소
Find notes citing a source 링크가 아니라, 현재 키와 예전 키로 그 문헌을 인용한 노트 목록

이 명령들은 클립보드에 복사만 합니다. Hookmark 북마크를 실제로 만드는 것은 Word 내보내기의 선택 설정 Link exports in Hookmark 하나뿐이며, 기본은 꺼짐입니다.