레퍼런스

문제 해결

먼저 Diagnose setup을 실행하세요. 연결, 인덱스, 폴더, 다른 플러그인과의 충돌, 다른 볼트를 한 번에 점검하고 원인과 고칠 설정을 알려 줍니다. 아무것도 바꾸지 않습니다.

[@를 쳤는데 다른 목록이 뜬다

[@를 치면 문헌 제목과 @키 · 저자 · 연도 목록이 떠야 합니다. 노트 속 낱말이나 …md 파일 이름 목록이 뜬다면 다른 플러그인의 자동완성이 먼저 답한 것입니다.

flowchart LR
  T["[@ 입력"] --> S1{"먼저 등록된 자동완성이 받나?"}
  S1 -->|"받음"| X["다른 플러그인의 목록"]
  S1 -->|"안 받음"| S2["CMDS Zotero"]
  S2 --> L["문헌 목록"]
  %% @key: S1
  %% @aux: X
Obsidian은 자동완성을 등록 순서대로 묻고, 처음 받겠다고 한 하나만 보여 줍니다.

Obsidian은 자동완성 플러그인을 등록 순서대로 물어보고, 처음 응답한 하나의 목록만 보여 줍니다. 그래서 고칠 곳은 CMDS Zotero가 아니라 먼저 응답하는 플러그인입니다. Diagnose setup의 Citation completion 줄이 어느 플러그인인지 알려 줍니다.

플러그인 고칠 설정
Various Complements 설정의 First characters to disable suggestions에 [와 @를 더합니다. 다른 문자가 이미 있으면 그 뒤에 붙입니다
Pandoc Reference List 설정에서 citekey 자동완성을 끕니다. 사이드바 기능은 그대로 써도 됩니다

[[로 시작하면 Obsidian의 노트 링크 자동완성이 뜹니다. 그 형식([[@key]])은 쪽수를 붙일 수 없으니 인용은 늘 [@로 시작합니다. 잘린 키([@luhmannKommunik처럼 끝까지 들어가지 않은 키)가 들어간 적이 있다면 같은 원인입니다.

연결과 인덱스

증상 확인할 것
상태 표시줄의 Zotero 숫자가 0이거나 연결 실패 Zotero와 Better BibTeX가 켜져 있는지, Server endpoint가 localhost인지, 그다음 Refresh citekey index
방금 Zotero에 넣은 문헌이 자동완성에 없음 인덱스가 오래됨. Refresh citekey index
인덱스 갱신이 거부됨 옛 플러그인 cmds-link-zotero가 켜져 있는지
인덱스 갱신 중 Zotero가 느려짐 Advanced의 Refresh requests를 낮춤
최근 읽은 논문이 비어 있음 Zotero 실행 여부, 기간, PDF를 Zotero 리더로 열었는지
최근 읽은 논문에서 Zotero 10이 필요하다고 함 읽기 기록은 Zotero 10 이상에서만 제공

인용

증상 확인할 것
인용 아래 물결 밑줄 인덱스에 없는 키, 여러 항목의 키, 예전 키 중 하나. Check citations in current note가 어느 것인지 알려 줌
예전 키라고 표시됨 Zotero에서 키가 바뀜. Fix renamed citekey in this note
인용 선택 창이 "No citation was picked" 창을 닫았거나 Picker wait가 지남. 다시 실행
PDF가 다른 쪽으로 열림 인쇄 쪽과 파일 안 위치가 다름. 쪽 라벨이 없는 PDF는 파일 위치 기준

문헌 노트

증상 확인할 것
새 하이라이트가 노트에 없음 Zotero가 꺼져 있으면 저장된 인덱스로 렌더링됨. Zotero를 켜고 다시 보내기
"not created by CMDS Zotero"로 거절 다른 플러그인이 만든 노트. 덮어쓰지 않음. Adopt current note as literature note로 넘겨받기
가져오기 차단(손상된 표식) 미리보기의 줄 번호에서 표식을 고치거나 Reset, 또는 Rebuild current literature note
Update all이 바로 시작하지 않고 목록을 보여 줌 모든 일괄 작업은 먼저 검토 목록을 보여 줌. 행을 고르고 적용
Better Notes 동기화 노트라며 건너뜀 Better Notes가 내용을 덮어쓰기 때문. 그 노트만 따로 갱신하면 경고 뒤 진행
Update literature notes changed in Zotero가 방금 주석 단 노트를 건너뜀 날짜는 인덱스에서 옴. 먼저 Refresh citekey index

Word와 pandoc

증상 할 일
보고 창에 "zotero.lua was not found" zotero.lua 넣기
터미널에 pandoc: command not found (Windows: 인식할 수 없는 명령) pandoc 설치 뒤 터미널이나 PowerShell을 새로 염
Run pandoc after export를 켰는데 pandoc을 못 찾음 Pandoc path에 which pandoc(Windows where pandoc) 결과를 적음
터미널에 @키: not found 그 키가 Zotero에 없거나 Zotero가 꺼져 있음
Word에 <Do Zotero Refresh: …>가 남음 Zotero를 켠 채 Zotero 탭에서 Refresh
Refresh 때 Document Preferences 창이 뜸 이 키트를 거치지 않은 파일. 스타일을 고르고 OK
"is not installed in Zotero" 원고의 csl 스타일을 Zotero 설정 → 인용 → 스타일에 설치하거나 apa로 둠
Word가 파일이 손상됐다고 함 같은 pandoc 명령을 다시 실행
내보내기 키트가 새 폴더를 제안함 이전 키트 파일을 고쳤음. 고친 키트는 덮어쓰지 않음
Word에서 맞춤법이 중국어로 검사됨 한국어 참조 문서 만들기. 한국어 원고에서
docx 속성에 볼트 정보가 남을까 걱정됨 0.6.6부터 문서에 필요한 frontmatter만 남김. 나머지는 보고 창에 목록으로 표시

Windows

  • pandoc 필터 폴더는 %APPDATA%\pandoc\filters입니다. macOS의 ~/.local/share/pandoc/filters와 다릅니다.
  • 복사된 명령은 큰따옴표로 감싼 경로를 씁니다. PowerShell에 그대로 붙여 넣습니다.
  • 한글 파일 이름이 깨져 보이면 압축을 푼 프로그램을 바꿔 봅니다. 실습 키트는 Windows에서 깨지지 않는 방식으로 묶었습니다.
  • Windows는 자동 테스트로 확인했습니다. 실제 Windows에서 막히는 점은 문제 신고로 알려 주세요.

Hookmark

증상 확인할 것
연결이 생기지 않음 Link exports in Hookmark와 Run pandoc after export가 둘 다 켜져 있어야 합니다. 연결은 pandoc이 docx를 만든 뒤에 합니다
macOS가 허용을 물음 처음 한 번, Obsidian이 Hookmark를 제어하도록 허용합니다. 거절했다면 시스템 설정 → 개인정보 보호 및 보안 → 자동화에서 켭니다
Hookmark가 없다고 함 Hookmark 앱이 없거나 macOS가 아님. 내보내기 자체는 정상

문제 신고

GitHub 이슈에 플러그인, Obsidian, Zotero, Better BibTeX 버전과 운영체제, 그리고 개인정보를 지운 Diagnose setup 보고서를 적어 주세요. 실제 인덱스 파일, 개인 경로, 주석 원문, PDF 텍스트 캐시는 올리지 않습니다.