CMDS Zotero0.6.6

시작

시작하기

설치부터 첫 인용까지 네 단계입니다. 처음 한 번만 하면 되는 일과 매번 하는 일을 나눠 두었습니다.

flowchart LR
  A["Zotero 쪽 준비"] --> B["플러그인 설치"]
  B --> C["설정 저장과 연결 시험"]
  C --> D["인덱스 갱신"]
  D --> E["첫 문헌 노트"]
  D --> F["첫 인용"]
  %% @key: D
  %% @aux: A
인덱스를 한 번 만들고 나면 자동완성과 점검은 Zotero를 부르지 않고 인덱스를 읽습니다.

준비물

무엇 언제 필요 비고
Obsidian 데스크톱 1.7.2 이상 항상 모바일은 지원하지 않습니다
Zotero 항상 플러그인이 쓰는 동안 실행 중이어야 합니다. 최근 읽은 논문 목록은 Zotero 10의 읽기 기록을 씁니다
Better BibTeX (Zotero 추가 기능) 항상 citekey와 로컬 연결 창구를 제공합니다. Zotero 쪽 준비
Zotero Word 플러그인 원고를 Word로 넘길 때 Zotero 설정에서 설치합니다
pandoc 2.17 이상 원고를 Word로 넘길 때 Obsidian 플러그인이 아니라 컴퓨터에 설치하는 프로그램입니다

Zotero Web API 키, Zotero 계정 로그인, 데이터베이스 접근, 별도 PDF 도구는 필요 없습니다.

1. 설치

커뮤니티 플러그인에서: 설정 → 커뮤니티 플러그인 → 탐색에서 CMDS Zotero를 검색해 설치하고 켭니다.

수동 설치: 최신 릴리스에서 main.js, manifest.json, styles.css 세 파일을 받아 <볼트>/.obsidian/plugins/cmds-zotero/ 폴더에 넣고, Obsidian을 다시 연 뒤 커뮤니티 플러그인 목록에서 켭니다.

BRAT: BRAT 플러그인에 johnfkoo951/cmds-zotero를 베타 플러그인으로 추가합니다. 새 버전이 나오면 BRAT가 업데이트를 받아 줍니다.

2. 설정 저장과 연결 시험

설정 → CMDS Zotero에서 세 경로를 확인합니다. 모두 볼트 안의 상대경로입니다.

설정 기본값 뜻
Output folder References/Zotero 새 문헌 노트가 생기는 폴더
Image folder References/Zotero/images 그림 주석 사본이 들어가는 폴더
Index path References/Zotero/zotero-index.json citekey 인덱스 파일

값을 바꿨다면 Save configuration을 누릅니다. 저장하기 전에는 이전 값이 쓰입니다. 이어서 Test connection을 누르면 저장된 주소로 Better BibTeX에 연결해 봅니다. 실패하면 Zotero가 켜져 있는지, Better BibTeX가 설치되어 있는지부터 봅니다.

3. 인덱스 갱신

명령 팔레트(⌘P, Windows는 CtrlP)에서 Refresh citekey index를 한 번 실행합니다. 아래 상태 표시줄의 숫자가 Zotero 항목 수만큼 늘어나면 됩니다.

인덱스는 Zotero 서재의 목록 사본입니다. 60분이 지나면 다음 조회 때 뒤에서 다시 만들고, Zotero가 꺼져 있어도 마지막 사본을 계속 씁니다. 자세한 내용은 핵심 개념에 있습니다.

4-1. 첫 문헌 노트

  1. Zotero 리더에서 논문 PDF를 열고 하이라이트나 메모를 몇 개 남깁니다.
  2. 명령 Send recently read papers to notes를 실행하거나, 왼쪽 리본의 펼친 책 아이콘을 누릅니다.
  3. 목록에서 논문마다 노트 상태가 보입니다. 보낼 필요가 있는 논문은 미리 선택되어 있습니다.
  4. Send를 누릅니다. 노트가 없으면 새로 만들고, 있으면 플러그인이 관리하는 부분만 갱신합니다.
  5. 노트의 ## Synthesis에 문장을 하나 쓰고, Zotero에서 하이라이트를 하나 더 한 뒤 다시 보내 봅니다. 내가 쓴 문장은 그대로 있고 새 주석만 더해지면 성공입니다.

이 마지막 확인이 이 플러그인을 믿고 쓸 수 있는 근거입니다. 왜 그렇게 되는지는 핵심 개념에서 설명합니다.

4-2. 첫 인용

  1. 아무 노트에서 [@를 치고 저자 이름이나 제목 일부를 입력합니다.
  2. 목록의 첫 줄은 문헌 제목, 둘째 줄은 @키 · 저자 · 연도입니다. Enter를 누르면 [@citekey]가 들어갑니다.
  3. 쪽수는 ] 앞에 , p. 12처럼 붙입니다.
  4. 명령 Check citations in current note를 실행해 모르는 키가 0개인지 확인합니다.

다른 목록(노트 속 낱말, 파일 이름)이 뜨면 다른 자동완성 플러그인이 먼저 가져간 것입니다. 문제 해결을 보세요.

업데이트와 이전

새 버전으로 올려도 설정(data.json)과 인덱스는 그대로 쓰입니다. 올리기 전에 플러그인 폴더를 한 번 백업해 두면 안전합니다.

옛 플러그인 ID cmds-link-zotero를 쓰던 볼트는 Obsidian을 끈 상태에서 저장소의 scripts/migrate-local.mjs를 dry-run, check, apply 순서로 실행해 옮깁니다. 옛 플러그인이 켜져 있으면 같은 인덱스 경로를 두고 다투므로 인덱스 갱신이 거부됩니다.