Trabajando con Bibliografía

Trabajando con Bibliografía

La función de citas y bibliografía de Word almacena sus datos de origen por separado de los campos que los renderizan. Aspose.Words FOSS para .NET modelos que obtienen datos a través del Aspose.Words.Bibliography namespace – Source, Contributor, Person, y Corporate – accesible desde Document.Bibliography. Esta página cubre la creación y lectura de esos datos; los CITATION and BIBLIOGRAPHY campos que los renderizan están cubiertos en el guía de enlaces y referencias.

El modelo de datos de la bibliografía

Document.Bibliography es una instancia de Bibliography con BibliographyStyle — el nombre del estilo de citación (por ejemplo APA o MLA) que debe aplicarse cuando se actualiza un campo BIBLIOGRAPHY — y Sources, un IList<Source> que contiene todos los registros de origen disponibles para el documento.

Registros de origen

Source se construye con Source(tag, sourceType), donde Tag es el identificador corto contra el que FieldCitation.SourceTag y FieldBibliography.SourceTag coinciden, y SourceType es un enum que identifica el tipo de fuente — los valores incluyen Book, BookSection, JournalArticle, ArticleInAPeriodical, ConferenceProceedings, Report, Patent, Case, InternetSite, DocumentFromInternetSite, Interview, Film, SoundRecording, Performance, Art, Electronic y Misc. Source.Type contiene por separado el tipo de fuente como una cadena simple. Más allá de Title y ShortTitle, Source expone docenas de campos específicos de categoría según sea necesario para el SourceType seleccionado — campos de libro (BookTitle, Edition, NumberVolumes, Volume, Pages, ChapterNumber), campos de publicación periódica (JournalName, PeriodicalTitle, PublicationTitle, Issue), campos web (InternetSiteTitle, Url, DayAccessed, MonthAccessed, YearAccessed), campos legales (CaseNumber, AbbreviatedCaseNumber, Court, Reporter), campos de grabación y difusión (AlbumTitle, Broadcaster, BroadcastTitle, RecordingNumber, Medium, ProductionCompany, Distributor, Station, Theater), PatentNumber, StandardNumber, campos de tesis (ThesisType, Institution, Department), y campos generales (Publisher, City, StateOrProvince, CountryOrRegion, Year, Month, Day, Comments, Guid, Doi, Version, RefOrder, Lcid).

Contributors

Source.Contributors es un ContributorCollection con una propiedad por rol de colaborador – Author, Editor, Translator, Compiler, Composer, Conductor, Counsel, Director, Interviewee, Interviewer, Inventor, Performer, Producer, Writer, Artist, y BookAuthor – cada una tipada como Contributor, la base común para los dos tipos de colaborador descritos a continuación.

Colaboradores Individuales vs. Corporativos

Contributor se implementa mediante dos clases: Person (First, Middle, Last) para un solo individuo, y Corporate (Name) para una organización. PersonCollection también deriva de Contributor e implementa IEnumerable<Person> (Add, Remove, RemoveAt, Clear, Contains, Count), por lo que un rol de colaborador que tiene varios autores individuales puede asignarse un PersonCollection tan fácilmente como a un rol con un solo autor se le asigna un Person – ambos, junto con Corporate, satisfacen la misma propiedad de rol tipada como Contributor.

Renderizado de contenido de bibliografía

Source Los registros solo suministran datos – no generan el texto de cita o bibliografía por sí mismos. Eso ocurre a través de FieldCitation and FieldBibliography, que buscan un Source mediante la coincidencia de SourceTag against Source.Tag. Ver el guía de enlaces y referencias para esas clases de campo.

Consejos y mejores prácticas

• Asigne a cada Source un Tag único – es el único valor que FieldCitation.SourceTag y FieldBibliography.SourceTag usan para encontrar el registro correcto.
• Rellene solo los campos Source relevantes para su SourceType – una fuente Book no tiene uso para Broadcaster o CaseNumber, por ejemplo, pero la clase no impone esto por usted.
• Utilice Person para un único colaborador nombrado, PersonCollection para varias personas en el mismo rol, y Corporate cuando el colaborador es una organización en lugar de una persona — asigne la que corresponda a la propiedad de rol ContributorCollection.
• Bibliography.BibliographyStyle registra qué nombre de estilo de citación aplicar; manténgalo coherente con la forma en que sus campos FieldCitation esperan que se formatee la salida.
• Agregue cada Source a Document.Bibliography.Sources antes de actualizar los campos CITATION o BIBLIOGRAPHY que lo referencian — una fuente ausente significa que el campo que hace referencia no tiene nada a lo que resolver.

Problemas comunes

FAQ

¿Cómo añado una fuente de libro con un solo autor?

Cree un Source con SourceType.Book, establezca BookTitle, Publisher, Year y los campos relacionados, luego asigne un Person a Source.Contributors.Author.

¿Cómo añado una fuente con varios autores?

Asignar un PersonCollection (poblado con Person instancias a través de Add()) a la propiedad de rol ContributorCollection correspondiente, como Author.

¿Cómo cito a una organización en lugar de a un individuo?

Asignar una instancia de Corporate (construida con el Name de la organización) a la propiedad de rol ContributorCollection en lugar de un Person o PersonCollection.

¿Dónde aparecen realmente los registros de Source en el documento renderizado?

No se renderizan por sí solos – FieldCitation and FieldBibliography los campos generan contenido construido a partir de ellos, coincidente con SourceTag. Ver el guía de enlaces y referencias.

Resumen de API Reference

Ver también

• Aspose.Words for .NET — Enterprise Documentation