레퍼런스

설정 전체

설정 → CMDS Zotero의 순서 그대로입니다. 값을 바꾼 뒤에는 Save configuration을 눌러야 적용되며, 입력하는 동안 값을 검사해 잘못된 경로나 범위를 알려 줍니다.

처음이라면

기본값 그대로 시작해도 됩니다. 아래 다섯 가지만 상황에 맞게 정해 두면 나머지는 쓰면서 바꾸면 됩니다.

상황 바꿀 설정
문헌 노트를 원래 쓰던 폴더에 두고 싶다 Output folder, Image folder
학회나 학교 양식이 APA가 아니다 Bibliography style (또는 원고마다 csl)
한국어 학술지에 낸다 Bibliography locale을 ko-KR (또는 원고마다 lang)
Word 파일을 볼트 밖에 두고 싶다 Allow export kits outside the vault, Export kit folder
인용에 마우스를 올려 서지를 보고 싶다 Citation hover preview

Connection

설정 기본값 뜻과 바꿀 때
Server endpoint http://127.0.0.1:23119/better-bibtex Better BibTeX의 로컬 주소. localhost 주소만 받습니다. Zotero 포트를 바꾼 경우에만 고칩니다
Test connection (단추) 저장된 주소로 연결을 시험합니다. 인용 선택 창은 열지 않습니다

Literature index

설정 기본값 뜻과 바꿀 때
Index path References/Zotero/zotero-index.json 인덱스 파일의 볼트 상대경로. 갱신이 성공한 뒤에만 이전 파일을 바꾸고, 최근 사본 세 개를 비공개 폴더에 백업합니다. 0.6.5 이전에 80. References/zotero-index.json을 쓰던 볼트는 그대로 씁니다
Maximum index age 60분 (1–10080) 이 시간이 지나면 다음 조회 때 인덱스를 다시 만듭니다. 서재가 크고 자주 바뀌지 않으면 늘립니다
Refresh saved index (단추) 지금 인덱스를 다시 만듭니다. 명령 Refresh citekey index와 같습니다

Citations

설정 기본값 뜻과 바꿀 때
Citation trigger Bracket 자동완성이 열리는 때. Bracket은 [@ 뒤, At sign은 낱말 앞 @ 뒤에도, Off는 끔
Citation format pandoc Zotero 인용 선택 창이 넣는 형식. pandoc이면 [@citekey]
Picker wait 600초 (30–1800) 인용 선택 창에서 고르기를 기다리는 시간. 알림의 Cancel로 언제든 멈춤
Default citation format Pandoc citation 인덱스에서 넣는 인용과 붙여 넣은 Zotero 링크의 형식
Mark citekey problems 켬 없는 키, 여러 항목이 쓰는 키, 예전 키에 밑줄
Citation hover preview 끔 인용에 마우스를 올리면 제목, 저자, 연도, 참고문헌 카드
Show citations as author-date 끔 읽기 보기와 실시간 미리보기에서 인용을 "(저자, 연도, p. 3)"으로 표시. 노트 글자는 그대로
Mod+click on a citation Nothing ⌘클릭(Windows Ctrl클릭)으로 열 것. Literature note 또는 PDF(인용한 쪽)
Paste Zotero links as citations 끔 붙여 넣거나 끌어 놓은 Zotero 항목 링크를 기본 형식의 인용으로

Literature notes

설정 기본값 뜻과 바꿀 때
Output folder References/Zotero 새 문헌 노트의 폴더. 이미 있는, 플러그인이 만들지 않은 파일은 덮어쓰지 않습니다
New note file name @{citekey} 새 노트 이름. 토큰 {citekey}, {title}, {shortTitle}, {year}, {firstAuthor}, {itemType}, {collection}
New note subfolder (비움) Output folder 아래 하위 폴더. 같은 토큰, 단계 사이는 /
Image folder References/Zotero/images 그림 주석 사본의 폴더
Excluded tags obscite 노트와 주석 태그에서 뺄 Zotero 태그. 한 줄에 하나, 대소문자 무시

Note layout

끈 구역은 빈 생성 블록으로 자리만 남습니다. 다시 켜면 같은 자리에 들어갑니다.

설정 기본값 뜻과 바꿀 때
Abstract 켬 제목 아래 초록
Bibliography entry 켬 참고문헌 문장. 끄면 첫 가져오기에 Zotero가 필요 없어짐
Metadata fields 켬 저자, 제목, 연도, citekey 같은 필드
Fields by item type 끔 항목 유형별 필드(학위논문의 대학, 보고서의 기관과 번호 등)와 날짜, 언어, Extra 필드
Links 켬 Zotero 항목과 첨부를 여는 링크
Join continued highlights 끔 코멘트가 +로 시작하는 하이라이트를 앞의 것에 붙임
Zotero rich text 끔 제목과 주석의 기울임, 굵게, 위첨자를 Markdown으로
Annotation tags Plain 주석 태그를 Zotero 그대로, 또는 Obsidian 태그(#method)로
Zotero notes 켬 항목의 Zotero 자식 노트
Synthesis scaffold 켬 새 노트의 Synthesis 제목과 콜아웃. 사용자 소유, 갱신하지 않음
Synthesis lines **Contribution**::, **Related**:: Synthesis 콜아웃의 줄. 한 줄에 하나
Annotations heading Annotations 새 노트의 주석 제목. 기존 노트는 원래 제목 유지
Abstract callout type Abstract 초록 콜아웃 종류
Bibliography callout type Cite 참고문헌 문장 콜아웃 종류
Metadata callout type md 메타데이터 콜아웃 종류
Links callout type LINK 링크 콜아웃 종류
Synthesis callout type Synth Synthesis 콜아웃 종류

Annotations

설정 기본값 뜻과 바꿀 때
Heading highlight color Gray 이 색 하이라이트는 노트에서 ##### 제목이 됨. None이면 모두 콜아웃
Follow the Zotero selection 끔 주석 사이드바가 Zotero 선택을 따라갈 때, 창에 초점이 올 때 읽을지, 몇 초마다 읽을지
Selection check interval 10초 (3–30) 몇 초마다 읽을 때의 간격

Bibliography and references

설정 기본값 뜻과 바꿀 때
Bibliography style apa Zotero에 설치된 CSL 스타일 ID. 원고의 csl이 우선. 저장할 때 Better BibTeX로 한 번 확인
Choose an installed style (단추) Zotero 데이터 폴더의 styles 목록에서 골라 확인 뒤 위 칸에 넣음
Bibliography locale (비움) 참고문헌 용어와 날짜의 언어. 예 ko-KR. 비우면 스타일 기본값. 원고의 lang이 우선
Bibliography order Style order 복사한 참고문헌과 참고문헌 구역의 순서. 처음 인용한 순서, 가나다순(알파벳순)도 가능
Zotero data directory ~/Zotero Zotero의 styles 폴더가 있는 곳. 읽기만 함
Allow export kits outside the vault 끔 켜면 Export kit folder에 볼트 밖 절대 경로나 ~/ 경로를 쓸 수 있음
Export kit folder CMDS Zotero exports 내보내기 키트의 폴더. 노트마다 하위 폴더
Run pandoc after export 끔 켜면 내보낸 뒤 pandoc을 실행하고 .docx를 엶. 끄면 명령을 복사
Pandoc path (비움) 실행할 pandoc. 비우면 흔한 설치 폴더, 그다음 시스템 검색 경로
Link exports in Hookmark 끔 macOS와 Hookmark가 있을 때 .docx와 원고 노트를 서로 연결
References sidebar follows the active note 켬 끄면 Refresh를 누를 때까지 보던 노트를 유지

Recently read

설정 기본값 뜻과 바꿀 때
Recently read window 30일 (7, 30, 90, 365) 최근 읽은 논문 목록이 보는 기간. 자료 선택 창도 이 논문들을 먼저 보여 줌

Connected vaults

설정 기본값 뜻과 바꿀 때
Peer vaults (비움) 한 줄에 `볼트 이름 \

Agent command line

설정 탭의 Advanced 아래에 있습니다.

설정 기본값 뜻과 바꿀 때
References headings References, Bibliography, Works Cited, 참고 문헌, 참고 자료 에이전트 cites, citing이 참고문헌 구역으로 볼 제목. Word kit은 참고문헌 구역이 없는 원고에 첫 제목을 씀

Requests

설정 탭의 Advanced 아래에 있습니다. 요청 한도는 대부분 기본값이면 됩니다.

설정 기본값 뜻과 바꿀 때
Request timeout 20초 (1–180) 메타데이터 요청의 시간 제한
Attachment timeout 60초 (1–180) PDF와 주석 요청의 시간 제한. 그림 주석이 많으면 늘림
Parallel requests 2 (1–8) 내보내기, 참고문헌, 읽기 기록 요청을 동시에 보내는 수
Refresh requests 4 (1–8) 인덱스 갱신 중 동시에 보내는 요청 수. 갱신할 때 Zotero가 느려지면 낮춤

설정은 어디에 저장되나

설정은 볼트의 .obsidian/plugins/cmds-zotero/data.json에 있습니다. 개인 경로와 서지가 들어갈 수 있으니 공개 저장소에 올리지 않습니다. 실습 키트처럼 볼트를 나눠 줄 때는 이 파일을 빼면 받는 사람은 기본값으로 시작합니다.