Lavorare con la bibliografia

Lavorare con la Bibliografia

La funzione di citazione e bibliografia di Word archivia i suoi dati sorgente separatamente dai campi che li visualizzano. Aspose.Words FOSS per .NET modelli che prelevano dati attraverso il Aspose.Words.Bibliography namespace – Source, Contributor, Person, e Corporate – raggiungibile da Document.Bibliography. Questa pagina tratta la creazione e la lettura di quei dati; i CITATION and BIBLIOGRAPHY campi che li visualizzano sono trattati nella guida a collegamenti e riferimenti.

Il modello di dati della Bibliografia

Document.Bibliography è un’istanza Bibliography con BibliographyStyle – il nome dello stile di citazione (ad esempio APA o MLA) che dovrebbe essere applicato quando un campo BIBLIOGRAPHY viene aggiornato – e Sources, un IList<Source> che contiene tutti i record di origine disponibili nel documento.

Record di origine

Source è costruito con Source(tag, sourceType), dove Tag è l’identificatore breve contro il quale FieldCitation.SourceTag e FieldBibliography.SourceTag effettuano il match, e SourceType è un enum che identifica il tipo di fonte – i valori includono Book, BookSection, JournalArticle, ArticleInAPeriodical, ConferenceProceedings, Report, Patent, Case, InternetSite, DocumentFromInternetSite, Interview, Film, SoundRecording, Performance, Art, Electronic e Misc. Source.Type contiene separatamente il tipo di fonte come stringa semplice. Oltre a Title e ShortTitle, Source espone decine di campi specifici per categoria secondo le necessità del SourceType scelto – campi del libro (BookTitle, Edition, NumberVolumes, Volume, Pages, ChapterNumber), campi di periodico (JournalName, PeriodicalTitle, PublicationTitle, Issue), campi web (InternetSiteTitle, Url, DayAccessed, MonthAccessed, YearAccessed), campi legali (CaseNumber, AbbreviatedCaseNumber, Court, Reporter), campi di registrazione e trasmissione (AlbumTitle, Broadcaster, BroadcastTitle, RecordingNumber, Medium, ProductionCompany, Distributor, Station, Theater), PatentNumber, StandardNumber, campi di tesi (ThesisType, Institution, Department), e campi generali (Publisher, City, StateOrProvince, CountryOrRegion, Year, Month, Day, Comments, Guid, Doi, Version, RefOrder, Lcid).

Contributors

Source.Contributors è un ContributorCollection con una proprietà per ruolo di contributore – Author, Editor, Translator, Compiler, Composer, Conductor, Counsel, Director, Interviewee, Interviewer, Inventor, Performer, Producer, Writer, Artist e BookAuthor – ciascuna tipizzata come Contributor, la base comune per i due tipi di contributore descritti di seguito.

Contributori individuali vs. aziendali

Contributor è implementato da due classi: Person (First, Middle, Last) per un singolo individuo, e Corporate (Name) per un’organizzazione. PersonCollection deriva anche da Contributor e implementa IEnumerable<Person> (Add, Remove, RemoveAt, Clear, Contains, Count), così un ruolo di contributore che ha più autori individuali può essere assegnato a un PersonCollection altrettanto facilmente quanto un ruolo con un solo autore è assegnato a un Person – entrambi, insieme a Corporate, soddisfano la stessa proprietà di ruolo tipizzata Contributor.

Rendering del contenuto della bibliografia

Source i record forniscono solo dati – non generano direttamente il testo di citazione o bibliografia. Questo avviene tramite FieldCitation and FieldBibliography, che cercano un Source corrispondendo a SourceTag against Source.Tag. Vedi il guida a collegamenti e riferimenti per quelle classi di campo.

Suggerimenti e migliori pratiche

• Assegna a ogni Source un Tag univoco – è l’unico valore che FieldCitation.SourceTag e FieldBibliography.SourceTag usano per trovare il record corretto.
• Compila solo i campi Source rilevanti per il suo SourceType – una fonte Book non ha bisogno di Broadcaster o CaseNumber, per esempio, ma la classe non impone questa restrizione per te.
• Usa Person per un singolo collaboratore nominato, PersonCollection per più individui nello stesso ruolo e Corporate quando il collaboratore è un’organizzazione piuttosto che una persona – assegna quello più adatto alla proprietà di ruolo ContributorCollection corrispondente.
• Bibliography.BibliographyStyle registra quale nome di stile di citazione applicare; mantienilo coerente con il modo in cui i campi FieldCitation si aspettano la formattazione dell’output.
• Aggiungi ogni Source a Document.Bibliography.Sources prima di aggiornare i campi CITATION o BIBLIOGRAPHY che lo fanno riferimento – una fonte mancante significa che il campo di riferimento non ha nulla a cui risolvere.

Problemi comuni

FAQ

Come aggiungere una fonte di libro con un unico autore?

Crea un Source con SourceType.Book, imposta BookTitle, Publisher, Year e i campi correlati, quindi assegna un Person a Source.Contributors.Author.

Come aggiungere una fonte con più autori?

Assegna un PersonCollection (popolato con Person istanze tramite Add()) alla proprietà di ruolo ContributorCollection pertinente, ad esempio Author.

Come posso citare un’organizzazione invece di un individuo?

Assegna un’istanza Corporate (costruita con il Name dell’organizzazione) alla proprietà di ruolo ContributorCollection invece di un Person o PersonCollection.

Dove compaiono effettivamente i record Source nel documento renderizzato?

Non vengono renderizzati da soli – FieldCitation and FieldBibliography i campi generano contenuto costruito da loro, corrispondente a SourceTag. Vedi il guida ai collegamenti e alle referenze.

Riepilogo API Reference

Vedi anche

• Aspose.Words for .NET — Enterprise Documentation