Travailler avec la bibliographie

Travailler avec la bibliographie

La fonction de citation et de bibliographie de Word stocke ses données sources séparément des champs qui les affichent. Aspose.Words FOSS pour .NET modèles qui récupèrent les données via le Aspose.Words.Bibliography namespace – Source, Contributor, Person, et Corporate – accessible depuis Document.Bibliography. Cette page couvre la création et la lecture de ces données ; les CITATION and BIBLIOGRAPHY champs qui les affichent sont couverts dans le guide des liens et des références.

Le modèle de données de la bibliographie

Document.Bibliography est une instance Bibliography avec BibliographyStyle — le nom du style de citation (par exemple APA ou MLA) qui doit être appliqué lorsqu’un champ BIBLIOGRAPHY est mis à jour — et Sources, un IList<Source> contenant chaque enregistrement source disponible dans le document.

Enregistrements sources

Source est construit avec Source(tag, sourceType), où Tag est l’identifiant court auquel FieldCitation.SourceTag et FieldBibliography.SourceTag correspondent, et SourceType est une énumération identifiant le type de source — les valeurs comprennent Book, BookSection, JournalArticle, ArticleInAPeriodical, ConferenceProceedings, Report, Patent, Case, InternetSite, DocumentFromInternetSite, Interview, Film, SoundRecording, Performance, Art, Electronic et Misc. Source.Type contient séparément le type de source sous forme de chaîne simple. Au-delà de Title et ShortTitle, Source expose des dizaines de champs spécifiques à chaque catégorie selon le SourceType choisi — champs de livre (BookTitle, Edition, NumberVolumes, Volume, Pages, ChapterNumber), champs de périodique (JournalName, PeriodicalTitle, PublicationTitle, Issue), champs web (InternetSiteTitle, Url, DayAccessed, MonthAccessed, YearAccessed), champs juridiques (CaseNumber, AbbreviatedCaseNumber, Court, Reporter), champs d’enregistrement et de diffusion (AlbumTitle, Broadcaster, BroadcastTitle, RecordingNumber, Medium, ProductionCompany, Distributor, Station, Theater), PatentNumber, StandardNumber, champs de thèse (ThesisType, Institution, Department), et champs généraux (Publisher, City, StateOrProvince, CountryOrRegion, Year, Month, Day, Comments, Guid, Doi, Version, RefOrder, Lcid).

Contributors

Source.Contributors est un ContributorCollection avec une propriété par rôle de contributeur – Author, Editor, Translator, Compiler, Composer, Conductor, Counsel, Director, Interviewee, Interviewer, Inventor, Performer, Producer, Writer, Artist et BookAuthor – chacune typée comme Contributor, la base commune pour les deux types de contributeur décrits ci-dessous.

Contributeurs individuels vs. contributeurs d’entreprise

Contributor est implémenté par deux classes : Person (First, Middle, Last) pour un individu unique, et Corporate (Name) pour une organisation. PersonCollection dérive également de Contributor et implémente IEnumerable<Person> (Add, Remove, RemoveAt, Clear, Contains, Count), de sorte qu’un rôle de contributeur ayant plusieurs auteurs individuels peut se voir attribuer un PersonCollection tout aussi facilement qu’un rôle avec un seul auteur se voit attribuer un Person – les deux, ainsi que Corporate, satisfont la même propriété de rôle de type Contributor.

Rendu du contenu de la bibliographie

Source les enregistrements ne fournissent que des données – ils ne rendent pas eux-mêmes le texte de citation ou de bibliographie. Cela se produit via FieldCitation and FieldBibliography, qui recherchent un Source en faisant correspondre SourceTag against Source.Tag. Voir le guide des liens et des références pour ces classes de champs.

Conseils et meilleures pratiques

• Attribuez à chaque Source un Tag unique – c’est la seule valeur que FieldCitation.SourceTag et FieldBibliography.SourceTag utilisent pour trouver l’enregistrement correct.
• Remplissez uniquement les champs Source pertinents pour son SourceType – une source Book n’a, par exemple, aucune utilité pour Broadcaster ou CaseNumber, mais la classe n’impose pas cela pour vous.
• Utilisez Person pour un contributeur nommé unique, PersonCollection pour plusieurs individus occupant le même rôle, et Corporate lorsque le contributeur est une organisation plutôt qu’une personne — attribuez ce qui convient à la propriété de rôle ContributorCollection correspondante.
• Bibliography.BibliographyStyle enregistre le nom du style de citation à appliquer; maintenez-le cohérent avec la façon dont vos champs FieldCitation attendent que leur sortie soit formatée.
• Ajoutez chaque Source à Document.Bibliography.Sources avant de mettre à jour les champs CITATION ou BIBLIOGRAPHY qui y font référence — une source manquante signifie que le champ référent n’a rien à résoudre.

Problèmes courants

FAQ

Comment ajouter une source de livre avec un seul auteur?

Créez un Source avec SourceType.Book, définissez BookTitle, Publisher, Year et les champs associés, puis attribuez un Person à Source.Contributors.Author.

Comment ajouter une source avec plusieurs auteurs?

Attribuez un PersonCollection (rempli avec Person instances via Add()) à la propriété de rôle ContributorCollection pertinente, comme Author.

Comment citer une organisation au lieu d’un individu?

Attribuez une instance Corporate (construite avec le Name de l’organisation) à la propriété de rôle ContributorCollection au lieu d’un Person ou d’un PersonCollection.

Où les enregistrements Source apparaissent-ils réellement dans le document rendu?

Ils ne s’affichent pas seuls – FieldCitation and FieldBibliography les champs rendent du contenu construit à partir d’eux, correspondant à SourceTag. Voir le guide des liens et des références.

API Reference Résumé

Voir aussi

• Aspose.Words for .NET — Enterprise Documentation