Πώς να εργαστείτε με τη βιβλιογραφία στο .NET
Αυτός ο οδηγός δείχνει πώς να δημιουργήσετε τα δεδομένα πηγής παραπομπής πίσω από τη λειτουργία βιβλιογραφίας του Word στο Aspose.Words FOSS για .NET, χρησιμοποιώντας το Source, Contributor, Person, και Corporate κλάσεις στο Aspose.Words.Bibliography χώρο ονομάτων. Καλύπτει τη δημιουργία εγγραφών πηγής, την επιλογή του σωστού τύπου πηγής, την ανάθεση ατομικών και εταιρικών συντελεστών, και την προσθήκη πηγών ώστε CITATION and BIBLIOGRAPHY τα πεδία να τις επιλύσουν.
Οδηγός βήμα-βήμα
Βήμα 1: Εγκατάσταση του πακέτου
Aspose.Words FOSS for .NET δεν έχει ακόμη δημοσιεύσει ένα πακέτο NuGet – δημιουργήστε τη βιβλιοθήκη από τον πηγαίο κώδικα αντί αυτού. Κλωνοποιήστε το https://github.com/aspose-words-foss/Aspose.Words-FOSS-for-.NET.git, στη συνέχεια δημιουργήστε το Aspose.Words.sln σε διαμόρφωση Release με το SDK .NET και αναφερθείτε στη δημιουργηθείσα συναρμολόγηση Aspose.Words από το έργο σας. Η βιβλιοθήκη στοχεύει στο .NET Standard 2.0, έτσι λειτουργεί στο .NET Framework 4.6.2+ και στο .NET 6/8/10.
Βήμα 2: Εισαγωγή των απαιτούμενων κλάσεων
Προσθέστε μια οδηγία using Aspose.Words; για το Document, και μια οδηγία using Aspose.Words.Bibliography; για τα Source, SourceType, Contributor, ContributorCollection, Person, PersonCollection και Corporate.
Βήμα 3: Προσπελάστε τα Δεδομένα Βιβλιογραφίας του Εγγράφου
Document.Bibliography επιστρέφει ένα Bibliography αντικείμενο. Η ιδιότητα Sources είναι ένα IList<Source> που περιέχει κάθε καταγραφή πηγής διαθέσιμη στο έγγραφο, και BibliographyStyle καταγράφει το όνομα του στυλ παραπομπής – για παράδειγμα APA ή MLA – που πρέπει να εφαρμοστεί όταν ένα πεδίο BIBLIOGRAPHY ενημερώνεται.
Βήμα 4: Δημιουργήστε μια Καταγραφή Πηγής
Δομήστε ένα Source με Source(tag, sourceType): το Tag είναι ο σύντομος αναγνωριστής με τον οποίο το FieldCitation.SourceTag και το FieldBibliography.SourceTag ταιριάζουν αργότερα, και το SourceType είναι μια τιμή enum που ταυτοποιεί το είδος της πηγής – Book, BookSection, JournalArticle, ArticleInAPeriodical, ConferenceProceedings, Report, Patent, Case, InternetSite, DocumentFromInternetSite, Interview, Film, SoundRecording, Performance, Art, Electronic ή Misc. Δώστε σε κάθε Source ένα μοναδικό Tag – είναι η μοναδική τιμή που τα πεδία παραπομπής χρησιμοποιούν για να βρουν τη σωστή καταγραφή.
Βήμα 5: Συμπληρώστε τα Πεδία για τον Επιλεγμένο Τύπο Πηγής
Πέρα από τα Title και ShortTitle, το Source εκθέτει δεκάδες πεδία ειδικά για κάθε κατηγορία – συμπληρώστε μόνο αυτά που σχετίζονται με τον επιλεγμένο SourceType. Οι πηγές βιβλίων χρησιμοποιούν τα BookTitle, Edition, NumberVolumes, Volume, Pages και ChapterNumber. Οι πηγές περιοδικών χρησιμοποιούν τα JournalName, PeriodicalTitle, PublicationTitle και Issue. Οι πηγές ιστού χρησιμοποιούν τα InternetSiteTitle, Url, DayAccessed, MonthAccessed και YearAccessed. Οι νομικές πηγές χρησιμοποιούν τα CaseNumber, AbbreviatedCaseNumber, Court και Reporter. Οι πηγές ηχογράφησης και μετάδοσης χρησιμοποιούν τα AlbumTitle, Broadcaster, BroadcastTitle, RecordingNumber, Medium, ProductionCompany, Distributor, Station και Theater. Τα γενικής χρήσης πεδία ισχύουν για τις περισσότερες κατηγορίες πηγών: Publisher, City, StateOrProvince, CountryOrRegion, Year, Month, Day, Comments, Guid, Doi, Version, RefOrder και Lcid.
Βήμα 6: Αναθέστε Ατομικούς Συνεργάτες
Source.Contributors επιστρέφει ένα ContributorCollection με μία ιδιότητα για κάθε ρόλο συνεργάτη – Author, Editor, Translator, Compiler, Composer, Conductor, Counsel, Director, Interviewee, Interviewer, Inventor, Performer, Producer, Writer, Artist και BookAuthor – καθεμία τυποποιημένη ως η αφηρημένη βάση κλάσης Contributor. Εκχωρήστε ένα Person (κατασκευασμένο από Last, First, Middle) σε μια ιδιότητα ρόλου για ένα μόνο ονομασμένο άτομο.
Βήμα 7: Ανάθεση Πολλαπλών ή Εταιρικών Συνεργατών
Όταν ένας ρόλος έχει περισσότερους από έναν ατομικούς συνεργάτες, αναθέστε ένα PersonCollection αντί για ένα μόνο Person – PersonCollection επίσης προέρχεται από το Contributor και υλοποιεί το IEnumerable<Person>, με Add(), Remove(), RemoveAt(), Clear(), Contains() και Count για τη διαχείριση των μελών του. Όταν ο συνεργάτης είναι οργανισμός αντί για άτομο, αναθέστε ένα Corporate (που κατασκευάζεται από το Name) στην ιδιότητα ρόλου αντί αυτού. Person, PersonCollection και Corporate ικανοποιούν όλα την ίδια ιδιότητα ρόλου τύπου Contributor, οπότε επιλέξτε όποιο ταιριάζει στην πηγή.
Βήμα 8: Προσθέστε την Πηγή ώστε τα Πεδία Παράθεσης να την Επίλυσουν
Προσθέστε κάθε ολοκληρωμένο Source to Document.Bibliography.Sources πριν από την ενημέρωση οποιουδήποτε CITATION or BIBLIOGRAPHY το πεδίο που το αναφέρει — μια πηγή που δημιουργήθηκε αλλά ποτέ δεν προστέθηκε δεν έχει τίποτα για το πεδίο αναφοράς να επιλύσει. Source τα αρχεία παρέχουν μόνο δεδομένα· δεν εμφανίζουν κείμενο παραπομπής ή βιβλιογραφίας από μόνα τους. Η απόδοση γίνεται μέσω FieldCitation and FieldBibliography, καλυμμένο στο οδηγό συνδέσμων και αναφορών.
Κοινά Προβλήματα και Διορθώσεις
Ένα πεδίο CITATION ή BIBLIOGRAPHY δεν επιλύεται Το Source.Tag δεν ταιριάζει ακριβώς με το πεδίο SourceTag. Επιβεβαιώστε ότι οι ετικέτες ταιριάζουν, και ότι το Source προστέθηκε πραγματικά στο Document.Bibliography.Sources.
Λάθος τύπος συνεισφέροντος ανατέθηκε σε ρόλο Ένα Person ανατέθηκε όπου υπάρχουν πολλαπλοί συνεισφέροντες, ή αντίστροφα. Χρησιμοποιήστε PersonCollection για πολλαπλά άτομα σε έναν ρόλο, Person για ένα μόνο άτομο, και Corporate για έναν οργανισμό.
Τα πεδία πηγής φαίνονται ασυνεπή για τον τύπο του Πεδία για ένα διαφορετικό SourceType συμπληρώθηκαν – για παράδειγμα, πεδία web όπως Url and DayAccessed ορίσθηκαν σε ένα Book πηγή. Συμπληρώστε μόνο τα πεδία που σχετίζονται με το επιλεγμένο SourceType.
Μια πηγή με πολλούς συγγραφείς εμφανίζει μόνο ένα όνομα Ένα μόνο Person ανατέθηκε σε Author αντί για ένα PersonCollection. Δημιουργήστε ένα PersonCollection, προσθέστε κάθε Person with Add(), και εκχωρήστε τη συλλογή στην ιδιότητα role.
BibliographyStyle δεν ταιριάζει με τη μορφή παραπομπής που αναμένω Bibliography.BibliographyStyle καταγράφει το όνομα του στυλ παραπομπής που θα εφαρμοστεί – διατηρήστε το συνεπές με τον τρόπο που το έγγραφο FieldCitation τα πεδία αναμένουν τη μορφή της εξόδου τους.
Συχνές Ερωτήσεις
Πώς προσθέτω μια πηγή βιβλίου με έναν μόνο συγγραφέα;
Δημιουργήστε ένα Source με SourceType.Book, ορίστε BookTitle, Publisher, Year, και τα συναφή πεδία, στη συνέχεια εκχωρήστε ένα Person στο Source.Contributors.Author.
Πώς προσθέτω μια πηγή με πολλούς συγγραφείς;
Εκχωρήστε ένα PersonCollection – συμπληρωμένο με Person παραδείγματα μέσω Add() – στη σχετική ιδιότητα ContributorCollection role property, όπως το Author.
Πώς μπορώ να παραθέσω έναν οργανισμό αντί για ένα άτομο;
Αντιστοιχίστε ένα παράδειγμα Corporate, που κατασκευάζεται με το Name του οργανισμού, στην ιδιότητα ρόλου ContributorCollection αντί για ένα Person ή PersonCollection.
Πού εμφανίζονται πραγματικά οι εγγραφές Πηγής στο αποδιδόμενο έγγραφο;
Δεν αποδίδονται από μόνα τους – FieldCitation and FieldBibliography τα πεδία αποδίδουν περιεχόμενο που δημιουργείται από αυτά, ταιριάζοντας με SourceTag. Δείτε το οδηγός συνδέσμων και παραπομπών.
Τι αναγνωρίζει μια εγγραφή Πηγής στα πεδία που την παραθέτουν;
Source.Tag, ορίζεται στον κατασκευαστή Source(tag, sourceType) — τα FieldCitation.SourceTag και FieldBibliography.SourceTag ταιριάζουν με αυτή την ακριβή τιμή.
