Lucrul cu bibliografia

Lucrul cu bibliografia

Funcția de citare și bibliografie a Word stochează datele sursă separat de câmpurile care le afișează. Aspose.Words FOSS pentru .NET modele care preiau datele prin Aspose.Words.Bibliography spațiu de nume – Source, Contributor, Person, și Corporate – accesibil din Document.Bibliography. Această pagină acoperă construirea și citirea acelor date; câmpurile CITATION and BIBLIOGRAPHY câmpurile care le afișează sunt acoperite în ghid de linkuri și referințe.

Modelul de date al bibliografiei

Document.Bibliography este o instanță Bibliography cu BibliographyStyle – numele stilului de citare (de exemplu APA sau MLA) care ar trebui aplicat când un câmp BIBLIOGRAPHY este actualizat – și Sources, un IList<Source> ce conține fiecare înregistrare sursă disponibilă în document.

Înregistrări sursă

Source este construit cu Source(tag, sourceType), unde Tag este identificatorul scurt la care FieldCitation.SourceTag și FieldBibliography.SourceTag se potrivesc, iar SourceType este un enum care identifică tipul sursei – valorile includ Book, BookSection, JournalArticle, ArticleInAPeriodical, ConferenceProceedings, Report, Patent, Case, InternetSite, DocumentFromInternetSite, Interview, Film, SoundRecording, Performance, Art, Electronic și Misc. Source.Type reține separat tipul sursei ca un șir simplu. Dincolo de Title și ShortTitle, Source expune zeci de câmpuri specifice categoriei, după cum este necesar pentru SourceType ales – câmpuri de carte (BookTitle, Edition, NumberVolumes, Volume, Pages, ChapterNumber), câmpuri de periodică (JournalName, PeriodicalTitle, PublicationTitle, Issue), câmpuri web (InternetSiteTitle, Url, DayAccessed, MonthAccessed, YearAccessed), câmpuri juridice (CaseNumber, AbbreviatedCaseNumber, Court, Reporter), câmpuri de înregistrare și difuzare (AlbumTitle, Broadcaster, BroadcastTitle, RecordingNumber, Medium, ProductionCompany, Distributor, Station, Theater), PatentNumber, StandardNumber, câmpuri de teză (ThesisType, Institution, Department), și câmpuri generale (Publisher, City, StateOrProvince, CountryOrRegion, Year, Month, Day, Comments, Guid, Doi, Version, RefOrder, Lcid).

Contributors

Source.Contributors este un ContributorCollection cu o proprietate pentru fiecare rol de contribuitor – Author, Editor, Translator, Compiler, Composer, Conductor, Counsel, Director, Interviewee, Interviewer, Inventor, Performer, Producer, Writer, Artist și BookAuthor – fiecare tipizat ca Contributor, baza comună pentru cele două tipuri de contribuitor descrise mai jos.

Contribuitori individuali vs. corporativi

Contributor este implementat prin două clase: Person (First, Middle, Last) pentru un singur individ, și Corporate (Name) pentru o organizație. PersonCollection de asemenea derivă din Contributor și implementează IEnumerable<Person> (Add, Remove, RemoveAt, Clear, Contains, Count), astfel încât un rol de contribuitor care are mai mulți autori individuali poate primi un PersonCollection la fel de ușor cum un rol cu un singur autor primește un Person – ambele, împreună cu Corporate, satisfac aceeași proprietate de rol tipizată Contributor.

Redarea conținutului bibliografiei

Source înregistrările furnizează doar date – nu generează ele însele textul de citare sau bibliografie. Acest lucru se întâmplă prin FieldCitation and FieldBibliography, care caută un Source prin potrivirea SourceTag against Source.Tag. Vezi ghid de linkuri și referințe pentru acele clase de câmpuri.

Sfaturi și bune practici

• Atribuiți fiecărui Source un Tag unic – este singura valoare pe care FieldCitation.SourceTag și FieldBibliography.SourceTag o folosesc pentru a găsi înregistrarea corectă.
• Completați doar câmpurile Source relevante pentru SourceType sale – de exemplu, o sursă Book nu are nevoie de Broadcaster sau CaseNumber, dar clasa nu impune acest lucru pentru dumneavoastră.
• Utilizaţi Person pentru un singur contribuitor numit, PersonCollection pentru mai multe persoane în acelaşi rol şi Corporate când contribuitorul este o organizaţie în loc de o persoană – atribuiţi ce se potriveşte proprietăţii de rol ContributorCollection.
• Bibliography.BibliographyStyle înregistrează numele stilului de citare de aplicat; păstraţi-l consecvent cu modul în care câmpurile FieldCitation îşi așteaptă ieşirea formatată.
• Adăugaţi fiecare Source la Document.Bibliography.Sources înainte de a actualiza câmpurile CITATION sau BIBLIOGRAPHY care fac referire la el – o sursă lipsă înseamnă că câmpul care face referire nu are la ce să se rezolve.

Probleme comune

FAQ

Cum adaug o sursă de carte cu un singur autor?

Creaţi un Source cu SourceType.Book, setaţi BookTitle, Publisher, Year și câmpurile aferente, apoi atribuiţi un Person la Source.Contributors.Author.

Cum adaug o sursă cu mai mulţi autori?

Atribuiți un PersonCollection (populat cu Person instanțe prin Add()) proprietății de rol ContributorCollection relevantă, cum ar fi Author.

Cum pot cita o organizație în loc de un individ?

Atribuiți o instanță Corporate (construită cu Name al organizației) proprietății de rol ContributorCollection în loc de un Person sau PersonCollection.

Unde apar de fapt înregistrările Source în documentul redat?

Nu se redau de la sine – FieldCitation and FieldBibliography câmpurile redau conținut construit din ele, potrivit de SourceTag. Vezi ghidul de linkuri și referințe.

API Reference Rezumat

Vezi și:

• Aspose.Words for .NET — Enterprise Documentation