각주 및 미주

각주와 미주

Aspose.Words FOSS for .NET은 각주와 미주를 단일 Footnote 노드 클래스로 표현하며, 이 클래스는 FootnoteType 속성으로 구분되고, Aspose.Words.Notes 네임스페이스에 별도의 번호 옵션 및 구분자 클래스가 함께 제공됩니다.


각주와 미주 내용 읽기

Footnote은(는) 복합 스토리 노드이며 — Body이나 테이블 셀과 같이, Paragraphs와 Tables을 포함하고 — 하나의 각주 또는 미주 텍스트를 보유합니다. 그 FootnoteType 속성(FootnoteType 열거형 값이며 Footnote 또는 Endnote)은 종류를 구분합니다. ReferenceMark은(는) 설정된 참조 표시 문자를 반환하고, ActualReferenceMark은(는) 실제로 렌더링된 표시(자동 번호 매기기를 고려)를 반환하며, IsAuto은(는) 표시가 자동 번호 매겨지는지 여부를 보고합니다. ParentParagraph은(는) 본문 문서 본체에서 각주 또는 미주 참조가 발생하는 단락을 찾습니다. GetText()은(는) 다른 스토리 수준 노드에서 사용할 수 있는 메서드와 동일하게 각주의 순수 텍스트 내용을 추출합니다.


번호 매기기 및 위치 구성

각주와 미주의 번호 매기기 및 배치 동작은 FootnoteOptions와 EndnoteOptions을 통해 별도로 제어되며, 두 개 모두 공유 IFootnoteOptions 인터페이스를 구현합니다. FootnoteOptions.Position(FootnotePosition 값 — BottomOfPage 또는 BeneathText)와 EndnoteOptions.Position(EndnotePosition 값 — EndOfSection 또는 EndOfDocument)은 각각의 유형이 배치되는 위치를 제어합니다. 두 개는 번호 순서를 제어하기 위해 NumberStyle, StartNumber, 및 RestartRule(FootnoteNumberingRule 값 — Continuous, RestartSection, RestartPage, 또는 Default)을 노출합니다. FootnoteOptions는 추가로 Columns을 노출하여, 페이지 하단에 여러 열로 각주를 배치할 수 있게 합니다.


각주와 미주 구분자

FootnoteSeparator은(는) Word가 본문과 각주/미주 사이에 삽입하는 콘텐츠를 보유하는 스토리 노드이며—기본적으로 짧은 가로선이지만, 어떤 단락 콘텐츠도 포함할 수 있습니다. 해당 SeparatorType 속성(FootnoteSeparatorType 값)은 Word가 정의한 여섯 가지 구분자 역할을 구분합니다: FootnoteSeparator, FootnoteContinuationSeparator, FootnoteContinuationNotice 및 미주에 해당하는 역할. FootnoteSeparatorCollection은(는) GetByFootnoteSeparatorType(FootnoteSeparatorType)을(를) 통해 문서 내 모든 구분자 노드에 대한 형식화된 접근을 제공합니다.


팁 및 모범 사례

  • Footnote.FootnoteType을(를) 확인한 후에 Footnote 노드가 각주라고 가정하지 마세요 — 같은 클래스가 각주와 미주 모두를 나타냅니다.
  • 자동 번호 매김 마크는 설정된 마크 문자와 다르므로, 실제로 렌더링되는 마크가 필요할 때는 ReferenceMark보다 ActualReferenceMark을(를) 사용하세요.
  • FootnoteOptions와 EndnoteOptions을(를) 각주/미주 콘텐츠를 추가하기 전에 설정하여 번호 매김 규칙이 첫 번째 노트부터 일관되게 적용되도록 하세요.
  • FootnoteSeparator 콘텐츠는 거의 사용자 지정되지 않습니다 — 대부분의 문서는 Word의 기본 구분자에 의존하지만, 문서에 맞춤형 연속 알림이 필요할 경우 완전히 접근 가능하도록 할 수 있습니다.

일반적인 문제

문제원인수정
각주와 미주가 처리 로직에서 혼동됨두 경우 모두 동일한 Footnote 클래스를 사용합니다Footnote.FootnoteType에 따라 분기
참조 표시 텍스트가 렌더링된 출력과 일치하지 않음ReferenceMark 대신 ActualReferenceMark을 사용함렌더링된 마크에 대한 ActualReferenceMark을 읽으세요
페이지/섹션마다 번호 매김이 예상치 않게 다시 시작됩니다RestartRule을 RestartPage 또는 RestartSection로 설정문서 전체 번호 매김을 위해 RestartRule을 Continuous으로 설정
페이지 하단에서 각주 열이 무시됩니다FootnoteOptions.Columns이 설정되지 않음FootnoteOptions에 Columns를 명시적으로 설정합니다.

FAQ

코드에서 각주와 미주를 어떻게 구분하나요?

Footnote 객체의 FootnoteType 속성을 확인하십시오 — FootnoteType.Footnote 또는 FootnoteType.Endnote을 반환합니다.

각주와 미주가 서로 다른 번호 매기기 규칙을 가질 수 있나요?

예 — FootnoteOptions와 EndnoteOptions은 독립적으로 구성되며, 각각 고유한 Position, NumberStyle, StartNumber, RestartRule를 가집니다.

FootnoteSeparator은(는) 무엇에 사용되나요?

이는 Word가 본문과 각주 또는 미주를 시각적으로 구분하기 위해 삽입하는 내용과, 각주가 다음 페이지로 이어질 때 표시되는 알림을 나타냅니다.

Footnote은(는) 노트 내부에 표를 지원하나요?

예 — Footnote은 Paragraphs와 함께 Tables 속성을 노출합니다. 이는 본문과 같은 복합 스토리 노드이기 때문입니다.


API Reference 요약

클래스 / 메서드설명
Footnote각주 또는 미주의 내용에 대한 컨테이너 노드
FootnoteType열거형: Footnote, Endnote
FootnoteOptions문서/섹션에 대한 각주 번호 매기기 및 위치 설정
EndnoteOptions문서/섹션에 대한 미주 번호 매기기 및 위치 설정
FootnotePosition / EndnotePosition배치를 위한 열거형 (BottomOfPage/BeneathText, EndOfSection/EndOfDocument)
FootnoteNumberingRule번호 매김이 다시 시작되는 시점을 제어하는 열거형
FootnoteSeparator각주/미주 구분자 내용에 대한 스토리 노드
FootnoteSeparatorCollection모든 FootnoteSeparator 노드에 대한 타입화된 접근
FootnoteSeparatorType노드가 나타내는 여섯 개 구분자 역할 중 어느 역할인지 식별하는 Enum

참조

 한국어