시작

Zotero 쪽 준비

플러그인은 Zotero에 아무것도 설치하지 않습니다. 필요한 추가 기능은 직접 설치하고 직접 관리합니다. 무엇이 꼭 필요하고 무엇이 선택인지부터 나눕니다.

#무엇을 설치하나

Zotero 밖에서 필요한 것도 하나 있습니다. 원고를 Word로 넘기려면 pandoc 프로그램과 Better BibTeX가 배포하는 zotero.lua 필터가 있어야 합니다. 이건 참고문헌과 Word에서 다룹니다.

flowchart TB
  subgraph Z["Zotero 안"]
    direction LR
    BBT["Better BibTeX"]
    ST["인용 스타일"]
    AT["Actions & Tags"]
  end
  subgraph O["Obsidian 안"]
    direction LR
    CZ["CMDS Zotero"]
  end
  subgraph W["Word 안"]
    direction LR
    WP["Zotero Word 플러그인"]
  end
  BBT -->|"서지, 주석, 읽기 기록"| CZ
  ST -->|"스타일 파일 읽기"| CZ
  AT -->|"노트 열기 링크"| CZ
  CZ -->|"Word kit"| WP
  WP -->|"인용 다시 그리기"| BBT
  %% @key: BBT, CZ
  %% @aux: AT

#Better BibTeX 설치

1. Better BibTeX 릴리스 페이지에서 .xpi 파일을 받습니다. Firefox로 받으면 설치를 시도하므로 다른 브라우저로 받거나 링크를 다른 이름으로 저장합니다.
2. Zotero에서 도구 → 플러그인을 엽니다.
3. 톱니 단추 → 파일에서 플러그인 설치를 고르고 받은 .xpi를 엽니다.
4. Zotero를 다시 시작합니다. 항목을 고르면 오른쪽 정보 창에 Citation Key가 보입니다.

#citekey 정하기

Better BibTeX는 항목마다 luhmannKommunikationMitZettelkaesten1981처럼 저자, 제목 낱말, 연도로 citekey를 만듭니다. 공식은 Better BibTeX 설정의 Citation keys에서 바꿀 수 있습니다.

원고를 쓰기 시작하면 키가 바뀌지 않는 것이 중요합니다. 메타데이터를 고칠 때 키가 따라 바뀌면 원고의 [@옛키]가 갈 곳을 잃기 때문입니다. Better BibTeX는 키를 고정(pin)하는 방법을 제공합니다(Better BibTeX 문서).

#인용 스타일 설치

Zotero 설정 → 인용 → 스타일에서 + 단추나 "추가 스타일 받기"로 스타일을 설치합니다. 플러그인은 Zotero 데이터 폴더의 styles 폴더를 읽기만 하며, Better BibTeX가 렌더링할 수 있는지 한 번 확인한 뒤 씁니다.

• 데이터 폴더가 ~/Zotero가 아니면 플러그인 설정의 Zotero data directory를 맞춥니다. Zotero 설정 → 고급 → 파일과 폴더에서 위치를 볼 수 있습니다.
• Word로 넘기는 원고의 스타일은 반드시 Zotero에 설치되어 있어야 합니다. Word의 Zotero 플러그인이 Zotero의 스타일로 인용을 그리기 때문입니다.

#Word 플러그인 설치

Zotero 설정 → 인용 → 워드 프로세서에서 Microsoft Word 추가 기능을 설치합니다. Word를 다시 열었을 때 리본에 Zotero 탭이 보이면 됩니다. LibreOffice나 Google Docs용 플러그인도 Zotero가 제공하지만, 이 설명서의 Word kit은 Microsoft Word 문서(.docx)를 기준으로 확인했습니다.

#Zotero에서 노트 열기 (선택)

Zotero에서 항목을 보다가 바로 그 문헌 노트를 열고 싶다면 Actions & Tags 애드온(2.6 이상)에 스크립트 하나를 더합니다. Zotero 10.0.3 이상이 필요합니다.

1. Obsidian에서 명령 Copy Zotero action script를 실행하고 동작을 고릅니다.
   • Open literature note: 이 볼트에서 항목의 노트를 엽니다.
   • Preview literature import: 항목의 가져오기 미리보기를 엽니다. 확인하기 전에는 아무것도 쓰지 않습니다.
2. Zotero 설정 → Actions & Tags에서 동작을 하나 추가하고, 작업을 Custom script로 정한 뒤 복사한 스크립트를 붙여 넣습니다.
3. "Open in Obsidian" 같은 이름을 붙이고 항목 메뉴, 리더 메뉴에 표시합니다. 원하면 단축키도 정합니다.
4. 처음 실행하면 Zotero가 obsidian:// 링크를 열어도 되는지 묻습니다. 허용합니다.

스크립트는 플러그인이 이미 받는 obsidian://cmds-zotero?vault=…&libraryID=…&itemKey=… 링크를 열 뿐이며, Zotero 서재를 바꾸지 않습니다. 첨부나 주석을 고르면 그 부모 항목으로 봅니다. 여러 항목을 고르면 Obsidian의 Open Zotero selection을 쓰라고 안내합니다.

#Zotero에 남는 것

없습니다. 플러그인은 Zotero 설정, 데이터베이스, citekey, 컬렉션, 태그, 첨부를 바꾸지 않습니다. Zotero 쪽에 생기는 변화는 사용자가 직접 설치한 추가 기능과 스타일뿐입니다.