상호 참조 옵션

개요

캡션 레이블과 참조를 사용자 지정할 수 있는 다양한 옵션을 제공하며, 모두 문서 메타데이터의 crossref 키 아래에서 지정합니다.

이 페이지에서는 자주 쓰이는 옵션을 중심으로 살펴보고, 전체 목록은 Cross-Reference Options 레퍼런스 페이지에서 확인할 수 있습니다.

LaTeX는 그림과 표의 서식과 레이아웃을 자체적으로 처리하므로 PDF로 렌더링할 때는 여기의 모든 옵션이 적용되지 않습니다. 특히 title-delim 같은 구분자 옵션과 labels 같은 번호 매기기 옵션은 PDF 출력에서 사용할 수 없습니다. 또한 LaTeX 캡션에서는 서식 지시어(예: 그림 제목을 이탤릭으로 변경)가 적용되지 않습니다.

제목

*-title 옵션을 사용하면 캡션에 쓰이는 제목 접두사를 지정할 수 있습니다. title-delim 옵션을 이용하면 접두사와 캡션 사이에 사용되는 구분자도 지정할 수 있습니다. 예시는 다음과 같습니다.

---
title: "My Document"
crossref:
  fig-title: Fig     # (기본값: "Figure")
  tbl-title: Tbl     # (기본값: "Table")
  title-delim: "—"   # (기본값: ":")
---

참조

*-prefix 옵션을 사용하면 인라인 참조에 쓰일 접두사를 지정할 수 있습니다. ref-hyperlink 옵션으로 참조에 하이퍼링크를 사용할지 여부도 설정할 수 있습니다. 예시는 다음과 같습니다.

---
title: "My Document"
crossref:
  fig-prefix: figure   # (기본값: "Figure")
  tbl-prefix: table    # (기본값: "Table")
  ref-hyperlink: false # (기본값: true)
---

번호 매기기

상호 참조에는 다음과 같이 여러 종류의 번호 매기기 방식을 사용할 수 있습니다.

• arabic (1, 2, 3)

• roman (I, II, III, IV)

• roman i (i, ii, iii, iv)

• alpha x (알파벳 ’x’부터 시작)

• alpha X (알파벳 ’X’부터 시작)

labels 옵션을 사용하면 (하위 참조를 제외한) 모든 유형에 적용할 번호 매기기 방식을 지정할 수 있습니다. 하위 참조(예: 하위그림)는 subref-labels 옵션으로 설정합니다. 예시는 다음과 같습니다.

---
title: "My Document"
crossref:
  labels: alpha a        # (기본값: arabic)
  subref-labels: roman i # (기본값: alpha a)
---

원한다면 *-labels 옵션으로 특정 유형만 별도로 지정할 수도 있습니다. 예시는 다음과 같습니다.

---
title: "My Document"
crossref:
  fig-labels: alpha a    # (기본값: arabic)
  tbl-labels: alpha a    # (기본값: arabic)
  subref-labels: roman i # (기본값: alpha a)
---

labels와 유형별 옵션을 동시에 지정하면 유형별 옵션이 우선합니다.

장 번호 연동

문서의 최상위 제목(H1)이 장을 나타내고, 상호 참조 번호에 장 번호를 함께 쓰려면 crossref: chapters 옵션을 사용합니다. 예시는 다음과 같습니다.

---
title: "My Document"
author: "Jane Doe"
number-sections: true
crossref:
  chapters: true
---

# Introduction

![Elephant](elephant.png){#fig-elephant}

See @fig-elephant for an illustration.