Práce s bibliografií

Práce s bibliografií

Funkce citací a bibliografie ve Wordu ukládá svá zdrojová data odděleně od polí, která je vykreslují. Aspose.Words FOSS pro .NET modely, které získávají data přes Aspose.Words.Bibliography jmenný prostor – Source, Contributor, Person, a Corporate – dostupné z Document.Bibliography. Tato stránka se zabývá vytvářením a čtením těchto dat; the CITATION and BIBLIOGRAPHY pole, která jej vykreslují, jsou pokryty v the průvodce odkazy a referencemi.

Datový model bibliografie

Document.Bibliography je instance Bibliography s BibliographyStyle – název citačního stylu (například APA nebo MLA), který by měl být použit při aktualizaci pole BIBLIOGRAPHY – a Sources, IList<Source> uchovávající každý zdrojový záznam dostupný v dokumentu.

Zdrojové záznamy

Source je vytvořen pomocí Source(tag, sourceType), kde Tag je krátký identifikátor, proti kterému se porovnávají FieldCitation.SourceTag a FieldBibliography.SourceTag, a SourceType je výčet (enum) určující typ zdroje – hodnoty zahrnují Book, BookSection, JournalArticle, ArticleInAPeriodical, ConferenceProceedings, Report, Patent, Case, InternetSite, DocumentFromInternetSite, Interview, Film, SoundRecording, Performance, Art, Electronic a Misc. Source.Type samostatně uchovává typ zdroje jako obyčejný řetězec. Kromě Title a ShortTitle Source poskytuje desítky kategorií-specifických polí podle potřeby zvoleného SourceType – pole pro knihy (BookTitle, Edition, NumberVolumes, Volume, Pages, ChapterNumber), pole pro periodika (JournalName, PeriodicalTitle, PublicationTitle, Issue), webová pole (InternetSiteTitle, Url, DayAccessed, MonthAccessed, YearAccessed), právní pole (CaseNumber, AbbreviatedCaseNumber, Court, Reporter), pole pro nahrávky a vysílání (AlbumTitle, Broadcaster, BroadcastTitle, RecordingNumber, Medium, ProductionCompany, Distributor, Station, Theater), PatentNumber, StandardNumber, pole pro diplomové práce (ThesisType, Institution, Department) a obecná pole (Publisher, City, StateOrProvince, CountryOrRegion, Year, Month, Day, Comments, Guid, Doi, Version, RefOrder, Lcid).

Contributors

Source.Contributors je 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á má typ Contributor, společná základna pro dva typy přispěvatelů popsaných níže.

Jednotliví a firemní přispěvatelé

Contributor je implementováno dvěma třídami: Person (First, Middle, Last) pro jediného jednotlivce a Corporate (Name) pro organizaci. PersonCollection také dědí z Contributor a implementuje IEnumerable<Person> (Add, Remove, RemoveAt, Clear, Contains, Count), takže roli přispěvatele, která má více jednotlivých autorů, může být přiřazen PersonCollection stejně snadno jako roli s jediným autorem může být přiřazen Person – oba, spolu s Corporate, splňují stejnou vlastnost role typu Contributor.

Vykreslování obsahu bibliografie

Source záznamy pouze poskytují data – nevyvolávají citaci ani bibliografický text samy. To se děje pomocí FieldCitation and FieldBibliography, které vyhledávají Source shodou SourceTag against Source.Tag. Viz průvodce odkazy a referencemi pro tyto třídy polí.

Tipy a osvědčené postupy

• Dejte každému Source jedinečný Tag – je to jediná hodnota, kterou FieldCitation.SourceTag a FieldBibliography.SourceTag používají k nalezení správného záznamu.
• Vyplňujte pouze pole Source relevantní pro jeho SourceType – například zdroj Book nemá využití pro Broadcaster nebo CaseNumber, ale třída vám toto neprosazuje.
• Použijte Person pro jediného pojmenovaného přispěvatele, PersonCollection pro více jednotlivců ve stejné roli a Corporate když je přispěvatel organizací spíše než osobou – přiřaďte to, co vyhovuje, k odpovídajícímu ContributorCollection role property.
• Bibliography.BibliographyStyle zaznamenává, který název citačního stylu použít; udržujte jej v souladu s tím, jak vaše pole FieldCitation očekávají formátovaný výstup.
• Přidejte každý Source do Document.Bibliography.Sources před aktualizací polí CITATION nebo BIBLIOGRAPHY, která na něj odkazují – chybějící zdroj znamená, že odkazující pole nemá co vyřešit.

Běžné problémy

FAQ

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řidám zdroj s více autory?

Přiřaďte PersonCollection (naplněný Person instancemi prostřednictvím Add()) k relevantnímu vlastnictví role ContributorCollection, například Author.

Jak citovat organizaci místo jednotlivce?

Přiřaďte instanci Corporate (sestavenou s Name organizace) k vlastnictví role ContributorCollection místo Person nebo PersonCollection.

Kde se záznamy Source ve skutečnosti objevují v renderovaném dokumentu?

Nezobrazují se samy o sobě – FieldCitation and FieldBibliography pole vykreslují obsah vytvořený z nich, spárovaný s SourceTag. Viz průvodce odkazy a referencemi.

API Reference Shrnutí

Viz také:

• Aspose.Words for .NET — Enterprise Documentation