A bibliográfiával való munka

A bibliográfiával dolgozás

A Word idézet- és bibliográfia-funkciója a forrásadatait külön tárolja azokat a mezőktől, amelyek megjelenítik őket. Aspose.Words FOSS a .NET modellek, amelyek adatot szereznek a Aspose.Words.Bibliography névtér – Source, Contributor, Person, és Corporate – elérhető innen Document.Bibliography. Ez az oldal lefedi az adat felépítését és olvasását; a CITATION and BIBLIOGRAPHY mezők, amelyek megjelenítik, a linkek és hivatkozások útmutató.

A bibliográfia adatmodellje

Document.Bibliography egy Bibliography példány, amely BibliographyStyle tartalmaz – a hivatkozási stílus neve (például APA vagy MLA), amelyet akkor kell alkalmazni, amikor egy BIBLIOGRAPHY mező frissül – és Sources, egy IList<Source>, amely minden a dokumentum számára elérhető forrásrekordot tartalmaz.

Forrásrekordok

Source a Source(tag, sourceType) alapján épül fel, ahol a Tag a rövid azonosító, amelyhez a FieldCitation.SourceTag és a FieldBibliography.SourceTag illeszkedik, és a SourceType egy felsorolás (enum), amely meghatározza a forrás típusát – az értékek között szerepelnek Book, BookSection, JournalArticle, ArticleInAPeriodical, ConferenceProceedings, Report, Patent, Case, InternetSite, DocumentFromInternetSite, Interview, Film, SoundRecording, Performance, Art, Electronic és Misc. A Source.Type külön tárolja a forrás típusát egyszerű szövegként. A Title és ShortTitle mellett a Source tucatnyi kategória-specifikus mezőt tesz elérhetővé a kiválasztott SourceType szerint – könyvmezők (BookTitle, Edition, NumberVolumes, Volume, Pages, ChapterNumber), folyóiratmezők (JournalName, PeriodicalTitle, PublicationTitle, Issue), webes mezők (InternetSiteTitle, Url, DayAccessed, MonthAccessed, YearAccessed), jogi mezők (CaseNumber, AbbreviatedCaseNumber, Court, Reporter), felvétel- és közvetítési mezők (AlbumTitle, Broadcaster, BroadcastTitle, RecordingNumber, Medium, ProductionCompany, Distributor, Station, Theater), PatentNumber, StandardNumber, szakdolgozat mezők (ThesisType, Institution, Department), és általános mezők (Publisher, City, StateOrProvince, CountryOrRegion, Year, Month, Day, Comments, Guid, Doi, Version, RefOrder, Lcid).

Contributors

Source.Contributors egy ContributorCollection, amely minden közreműködő szerepkörhöz egy tulajdonságot tartalmaz – Author, Editor, Translator, Compiler, Composer, Conductor, Counsel, Director, Interviewee, Interviewer, Inventor, Performer, Producer, Writer, Artist és BookAuthor – mindegyik Contributor típusú, ami a lent leírt két közreműködő típus közös alaptípusa.

Egyéni vs. vállalati közreműködők

Contributor két osztállyal van megvalósítva: Person (First, Middle, Last) egyetlen egyén számára, és Corporate (Name) egy szervezet számára. PersonCollection szintén a Contributor osztályból származik, és megvalósítja a IEnumerable<Person> (Add, Remove, RemoveAt, Clear, Contains, Count) interfészt, így egy olyan közreműködő szerepkör, amelynek több egyéni szerzője van, kap egy PersonCollection attribútumot ugyanolyan könnyedén, mint egy egyszeres szerzővel rendelkező szerepkör egy Person attribútumot – mindkettő, valamint a Corporate, teljesíti ugyanazt a Contributor típusú szerepkör tulajdonságot.

Bibliográfia tartalmának megjelenítése

Source A rekordok csak adatot szolgáltatnak – nem renderelnek hivatkozási vagy bibliográfiai szöveget magukban. Ez a következőn keresztül történik FieldCitation and FieldBibliography, amely egy Source illesztéssel SourceTag against Source.Tag. Lásd a linkek és hivatkozások útmutató azokhoz a mezőosztályokhoz.

Tippek és bevált gyakorlatok

• Adj minden Source számára egy egyedi Tag – ez az egyetlen érték, amelyet a FieldCitation.SourceTag és a FieldBibliography.SourceTag a megfelelő rekord megtalálásához használnak.
• Töltsd ki csak a Source mezőket, amelyek a SourceType-hez kapcsolódnak – például egy Book forrásnak nincs szüksége a Broadcaster vagy a CaseNumber mezőkre, de az osztály nem kényszeríti ezt ki.
• Használja a Person értéket egyetlen megnevezett közreműködőhöz, a PersonCollection értéket ugyanabban a szerepkörben több személy esetén, és a Corporate értéket, ha a közreműködő szervezet, nem személy – rendelje a megfelelő ContributorCollection szerepkör tulajdonsághoz.
• A Bibliography.BibliographyStyle rögzíti, hogy melyik idézési stílusnevet kell alkalmazni; tartsa összhangban azzal, ahogyan a FieldCitation mezők elvárják a kimenet formázását.
• Adjon minden Source elemet a Document.Bibliography.Sourceshez, mielőtt frissítené a CITATION vagy BIBLIOGRAPHY mezőket, amelyek hivatkoznak rá – egy hiányzó forrás azt jelenti, hogy a hivatkozó mezőnek nincs mire feloldania.

Gyakori problémák

FAQ

Hogyan adhatok hozzá egy könyvforrást egyetlen szerzővel?

Hozzon létre egy Source elemet a SourceType.Book segítségével, állítsa be a BookTitle, Publisher, Year és a kapcsolódó mezőket, majd rendelje hozzá a Person elemet a Source.Contributors.Authorhez.

Hogyan adhatok hozzá egy forrást több szerzővel?

Rendeljen egy PersonCollection (amely Person példányokkal van feltöltve a Add() segítségével) a megfelelő ContributorCollection szerepkör tulajdonsághoz, például Author.

Hogyan hivatkozhatok egy szervezetre egy egyén helyett?

Rendeljen egy Corporate példányt (amely a szervezet Name alapján van felépítve) a ContributorCollection szerepkör tulajdonsághoz a Person vagy PersonCollection helyett.

Hol jelennek meg valójában a Source rekordok a renderelt dokumentumban?

Nem jelennek meg önmagukban – FieldCitation and FieldBibliography a mezők a belőlük épített tartalmat jelenítik meg, amelyhez illeszkednek SourceTag. Lásd a linkek és hivatkozások útmutatója.

API Reference összefoglaló

Lásd még:

• Aspose.Words for .NET — Enterprise Documentation