Jak pracovat s bibliografií v .NET
Tento průvodce ukazuje, jak vytvořit data zdrojů citací za funkcí bibliografie ve Wordu v Aspose.Words FOSS pro .NET, pomocí Source, Contributor, Person, a Corporate třídy v Aspose.Words.Bibliography jmenný prostor. Pokrývá vytváření záznamů zdrojů, výběr správného typu zdroje, přiřazování individuálních a firemních přispěvatelů a přidávání zdrojů tak CITATION and BIBLIOGRAPHY pole mohou je rozpoznat.
Návod krok po kroku
Krok 1: Nainstalujte balíček
Aspose.Words FOSS for .NET zatím nepublikuje balíček NuGet – sestavte knihovnu ze zdrojového kódu. Klonujte https://github.com/aspose-words-foss/Aspose.Words-FOSS-for-.NET.git, pak sestavte Aspose.Words.sln v Release konfiguraci s .NET SDK a odkažte na vzniklý Aspose.Words assembly ve svém projektu. Knihovna cílí na .NET Standard 2.0, takže běží na .NET Framework 4.6.2+ a .NET 6/8/10.
Krok 2: Importujte požadované třídy
Přidejte using Aspose.Words; direktivu pro Document a using Aspose.Words.Bibliography; direktivu pro Source, SourceType, Contributor, ContributorCollection, Person, PersonCollection a Corporate.
Krok 3: Získat bibliografická data dokumentu
Document.Bibliography vrací instanci Bibliography. Jeho vlastnost Sources je IList<Source>, která obsahuje každý zdrojový záznam dostupný v dokumentu, a BibliographyStyle zaznamenává název citačního stylu – například APA nebo MLA – který by měl být použit, když je aktualizováno pole BIBLIOGRAPHY.
Krok 4: Vytvořit zdrojový záznam
Sestavte Source s Source(tag, sourceType): Tag je krátký identifikátor, proti kterému se později porovnává FieldCitation.SourceTag a FieldBibliography.SourceTag, a SourceType je výčtová hodnota určující typ zdroje – Book, BookSection, JournalArticle, ArticleInAPeriodical, ConferenceProceedings, Report, Patent, Case, InternetSite, DocumentFromInternetSite, Interview, Film, SoundRecording, Performance, Art, Electronic nebo Misc. Dejte každému Source jedinečný Tag – je to jediná hodnota, kterou citační pole používají k nalezení správného záznamu.
Krok 5: Vyplnit pole pro zvolený typ zdroje
Kromě Title a ShortTitle Source poskytuje desítky kategorií specifických polí – vyplňte jen ta, která jsou relevantní pro zvolený SourceType. Pro knižní zdroje se používají BookTitle, Edition, NumberVolumes, Volume, Pages a ChapterNumber. Pro periodické zdroje se používají JournalName, PeriodicalTitle, PublicationTitle a Issue. Pro webové zdroje se používají InternetSiteTitle, Url, DayAccessed, MonthAccessed a YearAccessed. Pro právní zdroje se používají CaseNumber, AbbreviatedCaseNumber, Court a Reporter. Pro záznamové a vysílací zdroje se používají AlbumTitle, Broadcaster, BroadcastTitle, RecordingNumber, Medium, ProductionCompany, Distributor, Station a Theater. Obecná pole se uplatňují napříč většinou typů zdrojů: Publisher, City, StateOrProvince, CountryOrRegion, Year, Month, Day, Comments, Guid, Doi, Version, RefOrder a Lcid.
Krok 6: Přiřadit jednotlivé přispěvatele
Source.Contributors vrací ContributorCollection s jednou vlastností pro každou roli přispěvatele – Author, Editor, Translator, Compiler, Composer, Conductor, Counsel, Director, Interviewee, Interviewer, Inventor, Performer, Producer, Writer, Artist a BookAuthor – každá je typu abstraktní základní třídy Contributor. Přiřaďte Person (sestrojený z Last, First, Middle) k vlastnosti role pro jedinou pojmenovanou osobu.
Krok 7: Přiřaďte více nebo firemní přispěvatele
Když má role více než jednoho individuálního přispěvatele, přiřaďte PersonCollection místo jediného Person – PersonCollection také vychází z Contributor a implementuje IEnumerable<Person>, s Add(), Remove(), RemoveAt(), Clear(), Contains() a Count pro správu jeho členů. Když je přispěvatelem organizace místo osoby, přiřaďte Corporate (sestrojený z jeho Name) k vlastnosti role místo toho. Person, PersonCollection a Corporate všechny splňují stejnou Contributor-typovanou vlastnost role, takže vyberte ten, který odpovídá zdroji.
Krok 8: Přidejte zdroj, aby pole citace jej mohlo rozpoznat
Přidejte každé dokončené Source to Document.Bibliography.Sources před aktualizací jakéhokoli CITATION or BIBLIOGRAPHY pole, které na něj odkazuje – zdroj, který byl vytvořen, ale nikdy přidán, nemá nic, na co by odkazující pole mohlo být vyřešeno. Source záznamy pouze poskytují data; samy nevytvářejí text citace nebo bibliografie. Vykreslování probíhá prostřednictvím FieldCitation and FieldBibliography, pokrytý v průvodci odkazů a referencí.
Časté problémy a opravy
Pole CITATION nebo BIBLIOGRAPHY se nevyřeší Ten Source.Tag neodpovídá přesně poli SourceTag. Potvrďte, že značky odpovídají, a že Source byl skutečně přidán k Document.Bibliography.Sources.
Špatný typ přispěvatele přiřazený k roli A Person byl přiřazen, kde existuje více přispěvatelů, nebo naopak. Použijte PersonCollection pro více jednotlivců v jedné roli, Person pro jednoho jednotlivce a Corporate pro organizaci.
Zdrojová pole vypadají nejednotně pro svůj typ Pole pro jiný SourceType byla vyplněna — například webová pole jako Url and DayAccessed nastaveno na Book zdroj. Vyplňte pouze pole relevantní pro vybraný SourceType.
Zdroj s více autory zobrazuje pouze jedno jméno Jedna Person byl přiřazen k Author místo PersonCollection. Vytvořte PersonCollection, přidejte každou Person with Add(), a přiřaďte kolekci k vlastnosti role.
BibliographyStyle neodpovídá citačnímu formátu, který očekávám Bibliography.BibliographyStyle zaznamenává, jaký název citačního stylu použít – udržte ho v souladu s tím, jaký je v dokumentu FieldCitation pole očekávají, že jejich výstup bude formátován.
Často kladené otázky
Jak přidám zdroj knihy s jediným autorem?
Vytvořte Source s SourceType.Book, nastavte BookTitle, Publisher, Year a související pole, poté přiřaďte Person k Source.Contributors.Author.
Jak přidat zdroj s více autory?
Přiřaďte PersonCollection – naplněný Person instancemi prostřednictvím Add() – relevantnímu ContributorCollection role property, například Author.
Jak mohu citovat organizaci místo jednotlivce?
Přiřaďte instanci Corporate, vytvořenou s Name organizace, k vlastnosti role ContributorCollection místo Person nebo PersonCollection.
Kde se záznamy Source ve skutečnosti objevují v vykresleném dokumentu?
Nezobrazují se samy – FieldCitation and FieldBibliography pole vykreslují obsah vytvořený z nich, spárovaný pomocí SourceTag. Viz průvodce odkazy a referencemi.
Co identifikuje záznam Source pro pole, která jej citují?
Source.Tag, nastavené v konstruktoru Source(tag, sourceType) – FieldCitation.SourceTag a FieldBibliography.SourceTag se porovnávají s touto přesnou hodnotou.
