2.6 교차 참조

우리는 이미 수식(섹션 2.2.1), 정리와 증명(섹션 2.2.2), 그림(섹션 2.4) 그리고 표(섹션 2.5)에서 상호 참조가 어떻게 작동하는지 설명한 바 있습니다.

실제로 동일한 구문 \@ref(label)을 사용하여 섹션을 참조할 수도 있습니다. 여기서 label은 ’섹션 ID’입니다. 기본적으로 Pandoc은 모든 섹션 헤더에 자동으로 ID를 생성합니다. 예를 들어 # Hello World 섹션에는 hello-world라는 ID가 있습니다.

섹션 헤더를 변경한 후 참조 라벨을 업데이트하는 것을 잊지 않도록 섹션 헤더에 ID를 수동으로 할당하는 것이 좋습니다. 섹션 헤더에 ID를 할당하려면 섹션 헤더 끝에 {#id}를 추가하면 됩니다. 섹션 헤더의 추가 속성은 표준 Pandoc 구문을 사용하여 설정할 수 있습니다.

참조된 라벨을 찾을 수 없는 경우 ??와 같은 두 개의 물음표가 표시되며, 책을 렌더링할 때 R 콘솔에 경고 메시지가 표시됩니다.

명시적이거나 자동 생성된 섹션 ID 또는 심지어 실제 섹션 헤더 텍스트를 사용하여 텍스트 기반 링크를 만들 수도 있습니다.

• 섹션 제목을 링크 텍스트로 사용하고 싶으면 간단하게 섹션의 제목을 대괄호 안에 사용하면 됩니다.
  • [섹션 제목]: 예, 섹션 3.4의 제목을 대괄호 안에 기입하여 [단일 문서] 형태로 기입하면 “단일 문서”라는 링크를 생성합니다.
  • [링크 텍스트][섹션 제목 텍스트] : 예, 섹션 4.5의 텍스트 링크를 위해 [비영어권 책][국제화]를 통한 “비영어권 책” 링크를 생성합니다.
  • [링크 텍스트](#ID), 예 : 섹션 2.5에 대하여 [표 작성](#Table)를 통해 “표 작성”의 링크를 생성합니다.

Pandoc 문서는 자동 섹션 ID 그리고 묵시적 헤더 참조에 대한 자세한 내용을 제공합니다.

PDF 또는 HTML 출력의 현재 페이지에 없는 항목을 참조하는 경우에도 상호 참조는 계속 작동합니다. 예를 들어 수식 (2.1) 그리고 그림 2.4를 참고하기 바랍니다.