2.2 교차 참조 (Cross References)
2.2.1 수식, 정리, 그리고 그림과 표의 교차 참조
We have explained how cross-references work for equations (Section 2.2.1), theorems (Section 2.2.2), figures (Section 2.4), and tables (Section 2.5). In fact, you can also reference sections using the same syntax ??, where label is the section ID.
2.2.2 ID 생성
기본적으로 Pandoc는 모든 절의 제목들에 대하여 ID를 생성한다. 예를 들어, 지금 이 장의 제목인 # Literature는 Literature라는 ID가 자동으로 가지게 된다. 그런데 이렇게 자동으로 생성되는 ID를 사용하는 것보다는 각 섹션의 제목에 대해 고유한 ID를 수작업으로 지정할 것을 추천한다. 이는 섹션 제목을 변경하는 경우 자동으로 생성한 ID도 변경되고 따라서 이를 참조하고 있는 다른 부분에서 이러한 섹션 ID를 변경할 필요를 없애기 위함이다.
섹션 헤더에 ID를 지정하기 위해서는 단순히 섹션 헤더의 끝 부분에 {#id}를 추가해 주면 된다. 이때 섹션 헤더의 추가적인 속성에 대해서는 Pandoc의 표준 구문을 사용하여 설정할 수 있다.
만일 이러한 참조 레이블이 발견되지 않는 경우, 본문에 ??가 표시되거나, 책을 렌더링할 때 R의 콘솔에 “경고 메시지”가 출력되게 된다.
2.2.3 텍스트 링크
You can also create text-based links using explicit or automatic section IDs or even the actual section header text.
- 각 장/절의 헤더(제목)을 링크 텍스트로 사용할 수 있다. 이때 이 헤더의 텍스트를 단순히 대괄호 안에 기입해 주면 링크가 생성된다 :
[Section header text]: 예를 들어, 위의 제목에 대해[Inline Formatting]을 사용하여 “Inline Formatting”으로 가는 링크를 생성할 수 있다.
- 사용자가 지정하는 링크를 만드는데는 다음과 같은 두 가지 방법이 있다.
The Pandoc documentation provides more details on automatic section IDs and implicit header references.
교차 참조는 현재 페이지에 있지 않은 항목들고 참고할 수 있다. 예를 들어, 제3장의 헤더에 #methods라는 섹선 ID가 설정되어 있다면, [Method](#methods)로 Method을 참조할 수 있다.