레퍼런스
문제 해결
먼저 Diagnose setup을 실행하세요. 연결, 인덱스, 폴더, 다른 플러그인과의 충돌, 다른 볼트를 한 번에 점검하고 원인과 고칠 설정을 알려 줍니다. 아무것도 바꾸지 않습니다.
[@를 쳤는데 다른 목록이 뜬다
[@를 치면 문헌 제목과 @키 · 저자 · 연도 목록이 떠야 합니다. 노트 속 낱말이나 …md 파일 이름 목록이 뜬다면 다른 플러그인의 자동완성이 먼저 답한 것입니다.
flowchart LR
T["[@ 입력"] --> S1{"먼저 등록된 자동완성이 받나?"}
S1 -->|"받음"| X["다른 플러그인의 목록"]
S1 -->|"안 받음"| S2["CMDS Zotero"]
S2 --> L["문헌 목록"]
%% @key: S1
%% @aux: XObsidian은 자동완성 플러그인을 등록 순서대로 물어보고, 처음 응답한 하나의 목록만 보여 줍니다. 그래서 고칠 곳은 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 텍스트 캐시는 올리지 않습니다.