참고문헌 작업

참고문헌 작업

Word의 인용 및 참고문헌 기능은 데이터를 렌더링하는 필드와 별도로 소스 데이터를 저장합니다. Aspose.Words FOSS for .NET 데이터를 통해 소스 데이터를 가져오는 모델 Aspose.Words.Bibliography 네임스페이스 – Source, Contributor, Person, 그리고 Corporate – 로부터 접근 가능 Document.Bibliography. 이 페이지는 해당 데이터를 구축하고 읽는 방법을 다루며; 그 CITATION and BIBLIOGRAPHY 이를 렌더링하는 필드는 다음에서 다룹니다 링크 및 참고 가이드.


참고문헌 데이터 모델

Document.Bibliography은 Bibliography 인스턴스로, BibliographyStyle를 포함합니다 – BIBLIOGRAPHY 필드가 업데이트될 때 적용되어야 하는 인용 스타일 이름(예: APA 또는 MLA) – 그리고 Sources, 모든 소스 레코드를 보유하는 IList<Source>입니다.


소스 레코드

Source은(는) Source(tag, sourceType)으로 구성되며, 여기서 Tag는 FieldCitation.SourceTag와 FieldBibliography.SourceTag가 일치하는 짧은 식별자이고, SourceType는 소스 종류를 식별하는 열거형이며 – 값에는 Book, BookSection, JournalArticle, ArticleInAPeriodical, ConferenceProceedings, Report, Patent, Case, InternetSite, DocumentFromInternetSite, Interview, Film, SoundRecording, Performance, Art, Electronic, 그리고 Misc가 포함됩니다. Source.Type은(는) 소스 유형을 일반 문자열로 별도로 저장합니다. Title와 ShortTitle를 넘어, Source은(는) 선택된 SourceType에 따라 필요한 수십 개의 카테고리별 필드를 노출합니다 – 도서 필드(BookTitle, Edition, NumberVolumes, Volume, Pages, ChapterNumber), 정기간행물 필드(JournalName, PeriodicalTitle, PublicationTitle, Issue), 웹 필드(InternetSiteTitle, Url, DayAccessed, MonthAccessed, YearAccessed), 법률 필드(CaseNumber, AbbreviatedCaseNumber, Court, Reporter), 녹음 및 방송 필드(AlbumTitle, Broadcaster, BroadcastTitle, RecordingNumber, Medium, ProductionCompany, Distributor, Station, Theater), PatentNumber, StandardNumber, 논문 필드(ThesisType, Institution, Department), 그리고 일반 필드(Publisher, City, StateOrProvince, CountryOrRegion, Year, Month, Day, Comments, Guid, Doi, Version, RefOrder, Lcid).


Contributors

Source.Contributors은 ContributorCollection이며, 기여자 역할당 하나의 속성을 가집니다 – Author, Editor, Translator, Compiler, Composer, Conductor, Counsel, Director, Interviewee, Interviewer, Inventor, Performer, Producer, Writer, Artist, 그리고 BookAuthor – 각각은 Contributor 타입이며, 아래에 설명된 두 종류의 기여자에 대한 공통 기반입니다.


개인 vs. 기업 기여자

Contributor은 두 클래스에 의해 구현됩니다: 단일 개인을 위한 Person (First, Middle, Last)와 조직을 위한 Corporate (Name). PersonCollection은 또한 Contributor을 상속하고 IEnumerable<Person> (Add, Remove, RemoveAt, Clear, Contains, Count)을 구현하므로, 다수의 개인 저자를 가진 기여자 역할은 PersonCollection을 할당받을 수 있으며, 단일 저자를 가진 역할이 Person을 할당받는 것과 마찬가지로 쉽습니다 – 이 두 경우와 Corporate은 모두 동일한 Contributor 타입의 역할 속성을 만족합니다.


참고문헌 내용 렌더링

Source 레코드는 데이터만 제공하며 – 인용이나 참고문헌 텍스트를 직접 렌더링하지 않습니다. 이는 다음을 통해 이루어집니다 FieldCitation and FieldBibliography, 이는 a를 찾아봅니다 Source 일치시켜 SourceTag against Source.Tag. 다음을 확인하십시오 링크 및 참고 가이드 해당 필드 클래스에 대해.


팁 및 모범 사례

  • 각 Source에 고유한 Tag을 부여하세요 – 이것은 FieldCitation.SourceTag와 FieldBibliography.SourceTag이 올바른 레코드를 찾기 위해 사용하는 유일한 값입니다.
  • 그 SourceType와 관련된 Source 필드만 채우세요 – 예를 들어, Book 소스는 Broadcaster이나 CaseNumber를 사용할 필요가 없지만, 클래스가 이를 강제하지는 않습니다.
  • 단일 명시된 기여자에 대해서는 Person을 사용하고, 동일 역할의 여러 개인에 대해서는 PersonCollection을 사용하며, 기여자가 개인이 아니라 조직일 경우에는 Corporate를 사용하십시오 – 해당 ContributorCollection 역할 속성에 맞는 것을 할당하십시오.
  • Bibliography.BibliographyStyle은 적용할 인용 스타일 이름을 기록합니다; FieldCitation 필드가 기대하는 출력 형식과 일관되게 유지하십시오.
  • Source을 모두 Document.Bibliography.Sources에 추가한 후에 CITATION 또는 BIBLIOGRAPHY 필드를 업데이트하십시오 – 누락된 소스는 참조하는 필드가 해결할 대상이 없음을 의미합니다.

일반적인 문제

문제원인해결
CITATION 또는 BIBLIOGRAPHY 필드가 해결되지 않습니다Source.Tag이(가) 필드의 SourceTag와 정확히 일치하지 않습니다태그가 일치하는지 확인하고, Source이(가) Document.Bibliography.Sources에 추가되었는지 확인하십시오
역할에 잘못된 기여자 유형이 할당되었습니다여러 기여자가 존재하는 경우에 Person이 할당되었거나, 그 반대의 경우도 있습니다하나의 역할에 여러 개인이 있을 경우 PersonCollection을 사용하고, 단일 개인의 경우 Person을 사용하며, 조직의 경우 Corporate을 사용하십시오
소스 필드가 해당 유형에 대해 일관되지 않아 보입니다.다른 SourceType에 대한 필드가 채워졌습니다 (예: Book 소스의 웹 필드).선택한 SourceType와 관련된 필드만 채우세요.

FAQ

단일 저자가 있는 책 소스를 어떻게 추가합니까?

SourceType.Book을(를) 사용하여 Source을 만들고, BookTitle, Publisher, Year 및 관련 필드를 설정한 다음, Source.Contributors.Author에 Person를 할당하십시오.

다중 저자가 있는 소스를 어떻게 추가합니까?

관련 ContributorCollection 역할 속성에 PersonCollection(을/를) Add()를 통해 Person 인스턴스로 채워서 할당하십시오. 예: Author.

개인이 아니라 조직을 인용하려면 어떻게 해야 하나요?

조직의 Name으로 구성된 Corporate 인스턴스를 Person 또는 PersonCollection 대신 ContributorCollection 역할 속성에 할당하십시오.

Source 레코드는 렌더링된 문서에서 실제로 어디에 표시됩니까?

그들은 자체적으로 렌더링되지 않습니다 – FieldCitation and FieldBibliography 필드는 그들로부터 구축된 콘텐츠를 렌더링하며, 다음에 의해 매칭됩니다 SourceTag. 자세히 보려면 링크 및 참고 가이드.


API Reference 요약

클래스 / 열거형설명
Bibliography서지 데이터 루트, Document.Bibliography을 통해; BibliographyStyle, Sources
Source개별 인용 출처; 카테고리별 필드 수십 개와 Contributors 포함
SourceType출처 유형 열거: Book, JournalArticle, InternetSite, Patent, Case, 등
ContributorCollection역할별 기여자 속성 (Author, Editor, Translator 등)은 Source에
ContributorPerson, PersonCollection, Corporate의 공통 기반
Person / PersonCollection단일 개인 기여자 또는 그들의 모음
Corporate기여자로 활동하는 조직

참조

 한국어