인용

개요

Quarto는 Pandoc을 사용해 다양한 스타일의 인용과 참고 문헌 목록을 자동 생성합니다. 이 기능을 활용하려면 다음이 필요합니다.

  • 인용 마크다운으로 작성된 Quarto 문서( 인용 마크다운 참조)
  • 참고 문헌 데이터 소스(예: BibLaTeX .bib, BibTeX .bibtex)
  • 선택 사항: 인용과 참고 문헌 형식을 정의하는 CSL 파일(natbib/biblatex를 사용하지 않을 때)
Note

format: typst는 기본적으로 Pandoc이 아닌 Typst가 인용 처리를 담당합니다. 자세한 내용은 아래 Typst 섹션을 참고하세요.

참고 문헌 파일

Quarto는 BibLaTeX와 CSL을 비롯해 다양한 참고 문헌 파일 형식을 지원합니다. 문서의 YAML 메타데이터에 bibliography 필드를 추가해 참고 문헌 파일을 지정하세요. 예:

---
title: "My Document"
bibliography: references.bib
---
Tip

bibliography 값을 YAML 배열로 지정하면 여러 참고 문헌 파일을 사용할 수 있습니다.

참고 문헌 파일 형식에 대한 자세한 설명은 Pandoc Citations을 참고하세요.

인용 문법

Quarto는 Pandoc 마크다운 인용 문법(예: [@citation])을 그대로 사용합니다. 인용은 대괄호 안에 입력하고 여러 인용은 세미콜론으로 구분합니다. 각 인용에는 키가 필요하며, @ + 데이터베이스의 식별자로 구성됩니다. 필요하다면 접두사(prefix), 위치(locator), 접미사(suffix)를 추가할 수 있습니다. 인용 키는 문자, 숫자 또는 _로 시작해야 하며, 영숫자와 _, :.#$%&-+?<>~/ 같은 내부 구두점을 포함할 수 있습니다. 예시는 다음과 같습니다.

마크다운 형식 | 출력(기본) | 출력 (csl: diabetologia.csl, Section 4 참고) | 
예시 문장 [see @knuth1984, pp. 33-35;
also @wickham2015, chap. 1]
 예시 문장 (see Knuth 1984, 33–35; also Wickham 2015, chap. 1) 예시 문장을 보라 [1], pp. 33-35; 또한 [1], chap. 1 
예시 문장 [@knuth1984, pp. 33-35,
38-39 and passim]
 예시 문장 (Knuth 1984, 33–35, 38–39 and passim) 예시 문장 [1], pp. 33-35, 38-39 and passim 
예시 문장 [@wickham2015; @knuth1984].
 예시 문장 (Wickham 2015; Knuth 1984). 예시 문장 [1, 2]. 
Wickham은 이렇게 말함 [-@wickham2015]
 Wickham은 이렇게 말함 (2015) Wickham은 이렇게 말함 [1]

다음과 같이 본문 내 인용도 사용할 수 있습니다.

마크다운 형식 | 출력(저자-연도) | 출력(숫자) | 
@knuth1984 가 이렇게 말함.     | @knuth1984 가 이렇게 말함.     | [1]이 이렇게 말함.
 
@knuth1984 [p. 33]이 이렇게 말함. | @knuth1984 [p. 33]이 이렇게 말함. | [1] [p. 33]이 이렇게 말

인용 문법에 대한 추가 정보는 Pandoc Citations을 참고하세요.

인용 스타일

Quarto는 Pandoc을 통해 인용과 참고 문헌을 서식화합니다. 기본값은 Chicago Manual of Style 저자-연도 형식이지만, CSL(Citation Style Language) 파일을 지정해 원하는 스타일을 사용할 수 있습니다. 문서 메타데이터에 csl 경로를 설정하면 됩니다.

---
title: "My Document"
bibliography: references.bib
csl: nature.csl
---

CSL 파일은 CSL Project나 Zotero 스타일 저장소에서 8,500개 이상을 확인할 수 있습니다.

cite-method가 기본값 citeproc일 때만 CSL 스타일링을 사용할 수 있습니다. 다른 cite-method를 사용하는 경우 해당 방식에서 제공하는 설정을 이용해 참고 문헌 형식을 조정해야 합니다.

참고 문헌 생성

스타일에서 요구하면 Pandoc이 자동으로 인용 목록을 생성하고 문서에 배치합니다. 문서에 refs ID를 가진 div가 있으면 그 안에 삽입됩니다.

### References

::: {#refs}
:::

해당 div가 없다면 문서 끝에 참고 문헌을 추가합니다.

Tip

문서 메타데이터에 suppress-bibliography: true를 설정하면 참고 문헌 생성을 비활성화할 수 있습니다.

생성된 참고 문헌 예시는 다음과 같습니다.

Knuth, Donald E. 1984. “Literate Programming.” The Computer Journal 27 (2): 97–111.
Wickham, Hadley. 2015. R Packages. 1st ed. O’Reilly Media, Inc.

미인용 항목 포함

본문에서 인용하지 않았지만 참고 문헌에 포함하려면 nocite 메타데이터 필드를 사용해 해당 항목을 나열하면 됩니다.

---
nocite: |
  @item1, @item2
---

@item3

위 예시에서는 본문에 item3만 인용되지만 참고 문헌에는 item1, item2, item3가 모두 포함됩니다.

와일드카드 @*를 사용하면 문서에 등장하지 않은 항목도 모두 참고 문헌에 포함할 수 있습니다.

---
nocite: |
  @*
---

LaTeX: using BibLaTeX or natbib

PDF를 만들 때 citeproc 기반의 기본 Pandoc 인용 처리를 사용하거나, 대신 natbib 또는 BibLaTeX를 사용할 수 있습니다. 이는 cite-method 옵션으로 제어합니다. 예:

format:
  pdf: 
    cite-method: biblatex

기본값은 citeproc(Pandoc 내장 인용 프로세서)입니다.

인용 문법, 사용 가능한 참고문헌 형식 등에 대한 자세한 내용은 Quarto의 Citations 문서를 참고하세요.

옵션

natbib 또는 biblatex를 사용할 때 참고문헌 렌더링 방식에 영향을 주는 다음 추가 옵션을 지정할 수 있습니다:

옵션 설명
biblatexoptions biblatex 옵션 목록
natbiboptions natbib 옵션 목록
biblio-title 참고문헌 제목
biblio-style 참고문헌 스타일

Typst

Typst에는 참고문헌을 위한 자체 인용 처리 시스템이 있으며 format: typst를 사용하면 기본값으로 이를 사용합니다. Typst 시스템으로 참고문헌 스타일을 지정하려면 bibliographystyle 옵션을 사용하세요. Typst의 내장 스타일 목록에서 문자열을 제공하면 됩니다. 예:

bibliography: refs.bib
bibliographystyle: apa

또는 로컬 CSL 파일 경로를 제공할 수 있습니다:

bibliography: refs.bib
bibliographystyle: my-csl-style.csl

Pandoc의 인용 처리를 사용하려면 YAML 헤더에 citeproc: true를 명시적으로 설정하세요:

citeproc: true
bibliography: refs.bib
csl: https://www.zotero.org/styles/apa-with-abstract

Pandoc 인용 처리 시스템에 인용 스타일 파일을 제공하려면 Citation Style에서 설명한 csl 옵션을 사용하세요.