사용법
인용 쓰기
원고에는 인용을 citekey로 씁니다. 모양(APA인지 각주인지)은 나중에 정하고, 지금은 어떤 문헌의 어느 쪽인지만 적습니다. 이 분리가 나중에 스타일을 마음대로 바꿀 수 있게 해 줍니다.
두 가지 넣는 길
sequenceDiagram participant A as 작성자 participant O as Obsidian 편집기 participant I as 인덱스 participant Z as Zotero A->>O: [@ 와 몇 글자 입력 O->>I: 후보 찾기 I-->>O: 제목, 저자, 연도 A->>O: Enter O-->>A: [@citekey] 삽입 Note over O,Z: 자동완성은 Zotero를 부르지 않습니다 A->>O: Insert citation from Zotero O->>Z: 인용 선택 창 열기 A->>Z: 문헌 고르기 Z-->>O: [@citekey] 삽입
[@ 자동완성
편집기에서 [@를 치고 citekey, 제목, 저자, 연도의 일부를 입력하면 목록이 뜹니다. 한글은 자모가 조합된 형태든 분리된 형태든 찾고, 악센트는 무시합니다(é는 e와 맞음).
| 키 | 넣는 것 |
|---|---|
| Enter | 인용 [@key] |
| ShiftEnter | 서술형 @key (문장 속 저자) |
| ⌘Enter (Windows CtrlEnter) | 문헌 노트 링크 |
목록 첫 줄은 제목, 둘째 줄은 @키 · 저자 · 연도입니다. 이 모양이 아니면 다른 플러그인의 목록입니다(문제 해결). 자동완성이 열리는 조건은 설정의 Citation trigger에서 바꿉니다. 기본은 [@ 뒤, 다른 값은 낱말 앞의 @ 뒤에도, 또는 끄기입니다.
새 인용은 커서에 있는 인용에 합쳐집니다. [@kim2020] 바로 뒤에서 [@로 하나 더 고르면 [@kim2020; @lee2021]이 됩니다.
Zotero 인용 선택기
Insert citation from Zotero는 Better BibTeX의 인용 선택 창(CAYW)을 띄웁니다. Word의 Zotero 창과 비슷하게 생겼습니다. 고르는 동안 Obsidian에는 취소 단추가 있는 알림이 뜨고, 설정의 Picker wait(기본 600초)까지 기다립니다. 그사이 다른 노트로 옮기면 인용을 노트 대신 클립보드에 넣습니다.
인용 형식
pandoc 인용 문법을 그대로 씁니다. 플러그인, pandoc, Word kit이 모두 같은 문법을 이해합니다.
| 쓰는 법 | 뜻 | APA로 그리면 |
|---|---|---|
[@key] |
괄호 인용 | (Luhmann, 1981) |
[@key, p. 224] |
쪽수 붙인 인용 | (Luhmann, 1981, p. 224) |
[@a; @b] |
여러 문헌 | (Schmidt, 2016, 2018) |
[see @key, pp. 33-35] |
앞말과 뒷말 | (see Schmidt, 2016, pp. 33–35) |
@key |
문장 속 저자 | Luhmann (1981) |
[-@key] |
저자 생략 | (1981) |
[[@key]] |
문헌 노트 링크 | 내보낼 때 [@key]로 바뀜 |
인덱스에서 넣는 명령은 형식마다 따로 있습니다. Insert citation from the literature index는 설정의 Default citation format으로 넣고, 아래 명령은 각자의 형식으로 넣습니다.
| 명령 | 결과 |
|---|---|
| Insert pandoc citation | [@key] |
| Insert narrative citation | @key |
| Insert citekey wikilink | [[@key]] |
| Insert author-date citation text | (Kim & Lee, 2020) 같은 글자. 인덱스로 만든 근사치이며 인용이 아님 |
| Insert Zotero item link | Zotero 항목을 여는 Markdown 링크 |
| Insert literature note link | [[문헌 노트|Kim & Lee, 2020]] |
필드 검색
자동완성과 자료 선택 창은 필드를 이해합니다. 앞에 -를 붙이면 제외하고, 공백이 있는 값은 따옴표로 묶습니다.
| 필드 | 예 |
|---|---|
author: |
author:luhmann |
title: |
title:zettelkasten |
year: |
year:2019-2021, year:2020- |
tag: |
tag:method, -tag:read |
col: |
col:"Thesis/Chapter 2" |
type: |
type:book |
has: |
has:pdf, has:annotations, -has:note |
lib: |
그룹 라이브러리 이름 |
편집기 안의 도움
문제 있는 키 표시
Mark citekey problems(기본 켬)는 세 가지 키에 밑줄을 긋습니다.
- 인덱스에 없는 키: 오타이거나 Zotero에 없는 문헌
- 여러 항목이 함께 쓰는 키: 어느 문헌인지 모호함
- 예전 키: Zotero에서 이름이 바뀐 키. Fix renamed citekey in this note로 고침
인덱스를 읽기 전이나 인덱스가 불완전할 때는 표시하지 않습니다.
미리보기와 저자-연도 보기
둘 다 기본으로 꺼져 있고, 노트 글자는 바꾸지 않습니다.
- Citation hover preview: 인용에 마우스를 올리면 제목, 저자, 연도, 참고문헌 카드를 보여 줍니다.
- Show citations as author-date: 읽기 보기와 실시간 미리보기에서
[@kim2020, p. 3]을 "(Kim & Lee, 2020, p. 3)"처럼 보여 줍니다. 커서를 대면 원래 글자가 보입니다. - Mod+click on a citation: 인용을 ⌘클릭(Windows Ctrl클릭)했을 때 문헌 노트를 열지, 그 쪽의 PDF를 열지 정합니다.
커서 인용 동작
Citation actions at cursor는 커서에 있는 인용으로 할 수 있는 일을 모아 보여 줍니다. 각각 명령으로도 있습니다.
| 명령 | 하는 일 |
|---|---|
| Open literature note for citation at cursor | 문헌 노트 열기. 없으면 가져오기 미리보기 |
| Open PDF at citation locator | 인용의 쪽으로 PDF 열기 |
| Copy PDF page link for citation at cursor | 그 쪽의 PDF 링크 복사 |
| Edit citation locator | 쪽수, 장 같은 위치 고치기 |
| Go to next / previous occurrence of the citation at cursor | 같은 문헌을 인용한 다음, 이전 자리로 |
| Fix renamed citekey in this note | 예전 키를 모두 새 키로. 미리보기, 실행 취소 한 번으로 되돌림 |
인용 점검과 참고문헌 사이드바
- Check citations in current note: 인덱스에 없는 키, 모호한 키, 예전 키, 문헌 노트가 없는 키,
nocite키를 목록으로 보여 줍니다. 각 자리를 노트에서 열 수 있습니다. 원고를 넘기기 전에 한 번 돌리는 습관을 권합니다. - Open references sidebar: 현재 노트가 인용한 문헌과 참고문헌 문장, 미해결 상태를 보여 줍니다. Zotero가 꺼져 있어도 저장된 참고문헌으로 표시합니다. 행마다 이전, 다음 인용 자리로 이동할 수 있습니다.
인용은 pandoc과 같은 방식으로 셉니다. 코드, HTML 주석, %% 주석 안의 인용, \@로 막은 것, 이메일 주소는 세지 않고, -@key와 frontmatter nocite의 키는 셉니다.
Zotero 링크 붙여 넣기
Paste Zotero links as citations(기본 끔)를 켜면 Zotero 항목 링크(zotero://select/…)를 붙여 넣거나 끌어 놓을 때 기본 형식의 인용으로 바꿔 넣습니다. 라이브러리와 item key로 맞추며, 인덱스가 모르는 링크는 그대로 붙여 넣습니다. 실행 취소 한 번이면 원래 링크로 돌아갑니다.