Werken met Bibliografie

Werken met Bibliografie

Word’s citation and bibliography feature slaat zijn brongegevens apart op van de velden die het weergeven. Aspose.Words FOSS voor .NET modellen die gegevens ophalen via de Aspose.Words.Bibliography namespace – Source, Contributor, Person, en Corporate – bereikbaar vanaf Document.Bibliography. Deze pagina behandelt het bouwen en lezen van die gegevens; de CITATION and BIBLIOGRAPHY velden die het weergeven worden behandeld in de gids voor links en referenties.

Het Bibliografie-datamodel

Document.Bibliography is een Bibliography instantie met BibliographyStyle – de citatiestijlnaam (bijvoorbeeld APA of MLA) die moet worden toegepast wanneer een BIBLIOGRAPHY veld wordt bijgewerkt – en Sources, een IList<Source> die elk bronrecord dat beschikbaar is voor het document bevat.

Bronrecords

Source wordt geconstrueerd met Source(tag, sourceType), waarbij Tag de korte identifier is waar FieldCitation.SourceTag en FieldBibliography.SourceTag tegen overeenkomen, en SourceType een enum is die het type bron identificeert – waarden omvatten Book, BookSection, JournalArticle, ArticleInAPeriodical, ConferenceProceedings, Report, Patent, Case, InternetSite, DocumentFromInternetSite, Interview, Film, SoundRecording, Performance, Art, Electronic en Misc. Source.Type bevat apart het brontype als een eenvoudige string. Naast Title en ShortTitle onthult Source tientallen categoriespecifieke velden die nodig zijn voor de gekozen SourceType – boekvelden (BookTitle, Edition, NumberVolumes, Volume, Pages, ChapterNumber), tijdschriftvelden (JournalName, PeriodicalTitle, PublicationTitle, Issue), webvelden (InternetSiteTitle, Url, DayAccessed, MonthAccessed, YearAccessed), juridische velden (CaseNumber, AbbreviatedCaseNumber, Court, Reporter), opname- en uitzendvelden (AlbumTitle, Broadcaster, BroadcastTitle, RecordingNumber, Medium, ProductionCompany, Distributor, Station, Theater), PatentNumber, StandardNumber, scriptievelden (ThesisType, Institution, Department), en algemene velden (Publisher, City, StateOrProvince, CountryOrRegion, Year, Month, Day, Comments, Guid, Doi, Version, RefOrder, Lcid).

Contributors

Source.Contributors is een ContributorCollection met één eigenschap per bijdragerrol – Author, Editor, Translator, Compiler, Composer, Conductor, Counsel, Director, Interviewee, Interviewer, Inventor, Performer, Producer, Writer, Artist en BookAuthor – elk getypeerd als Contributor, de gemeenschappelijke basis voor de twee soorten bijdragers die hieronder worden beschreven.

Individuele versus zakelijke bijdragers

Contributor wordt geïmplementeerd door twee klassen: Person (First, Middle, Last) voor één individu, en Corporate (Name) voor een organisatie. PersonCollection erft ook van Contributor en implementeert IEnumerable<Person> (Add, Remove, RemoveAt, Clear, Contains, Count), zodat een bijdragerrol met meerdere individuele auteurs kan worden toegewezen aan een PersonCollection net zo gemakkelijk als een rol met een enkele auteur wordt toegewezen aan een Person – beide, samen met Corporate, voldoen aan dezelfde Contributor-getypeerde rol-eigenschap.

Weergave van bibliografische inhoud

Source records leveren alleen gegevens – ze renderen zelf geen citatie- of bibliografietekst. Dat gebeurt via FieldCitation and FieldBibliography, die een opzoekt Source door te matchen SourceTag against Source.Tag. Zie de gids voor links en referenties voor die veldklassen.

Tips en best practices

• Geef elke Source een unieke Tag – het is de enige waarde die FieldCitation.SourceTag en FieldBibliography.SourceTag gebruiken om het juiste record te vinden.
• Vul alleen de Source-velden in die relevant zijn voor zijn SourceType – een Book-bron heeft bijvoorbeeld geen gebruik voor Broadcaster of CaseNumber, maar de klasse handhaaft dit niet voor je.
• Gebruik Person voor een enkele genoemde bijdrager, PersonCollection voor meerdere individuen in dezelfde rol, en Corporate wanneer de bijdrager een organisatie is in plaats van een persoon – wijs wat passend is toe aan de overeenkomstige ContributorCollection rol-eigenschap.
• Bibliography.BibliographyStyle registreert welke citatiestijlnaam moet worden toegepast; houd deze consistent met hoe uw FieldCitation velden hun uitvoer geformatteerd verwachten.
• Voeg elke Source toe aan Document.Bibliography.Sources voordat u de CITATION of BIBLIOGRAPHY velden bijwerkt die ernaar verwijzen – een ontbrekende bron betekent dat het verwijzende veld niets heeft om naar te verwijzen.

Veelvoorkomende problemen

FAQ

Hoe voeg ik een boekbron toe met één auteur?

Maak een Source met SourceType.Book, stel BookTitle, Publisher, Year en gerelateerde velden in, wijs vervolgens een Person toe aan Source.Contributors.Author.

Hoe voeg ik een bron toe met meerdere auteurs?

Ken een PersonCollection (gevuld met Person instanties via Add()) toe aan de relevante ContributorCollection rol-eigenschap, bijvoorbeeld Author.

Hoe citeer ik een organisatie in plaats van een individu?

Ken een Corporate instantie (geconstrueerd met de Name van de organisatie) toe aan de ContributorCollection rol-eigenschap in plaats van een Person of PersonCollection.

Waar verschijnen Source records daadwerkelijk in het gerenderde document?

Ze renderen niet op zichzelf – FieldCitation and FieldBibliography velden renderen inhoud die uit hen is opgebouwd, gematcht door SourceTag. Zie de links- en referentiegids.

API Reference Samenvatting

Zie ook

• Aspose.Words for .NET — Enterprise Documentation