Bekerja dengan Bibliografi

Bekerja dengan Bibliografi

Fitur sitasi dan bibliografi Word menyimpan data sumbernya secara terpisah dari bidang yang menampilkannya. Aspose.Words FOSS untuk .NET model yang mengambil data melalui the Aspose.Words.Bibliography namespace – Source, Contributor, Person, dan Corporate – dapat dijangkau dari Document.Bibliography. Halaman ini mencakup pembuatan dan pembacaan data tersebut; the CITATION and BIBLIOGRAPHY bidang yang menampilkannya dibahas dalam the panduan tautan dan referensi.

Model Data Bibliografi

Document.Bibliography adalah instance Bibliography dengan BibliographyStyle – nama gaya kutipan (misalnya APA atau MLA) yang harus diterapkan ketika bidang BIBLIOGRAPHY diperbarui – dan Sources, sebuah IList<Source> yang menyimpan setiap catatan sumber yang tersedia untuk dokumen.

Catatan Sumber

Source dibangun dengan Source(tag, sourceType), di mana Tag adalah identifier singkat yang dicocokkan oleh FieldCitation.SourceTag dan FieldBibliography.SourceTag, dan SourceType adalah enum yang mengidentifikasi jenis sumber – nilai-nilainya meliputi Book, BookSection, JournalArticle, ArticleInAPeriodical, ConferenceProceedings, Report, Patent, Case, InternetSite, DocumentFromInternetSite, Interview, Film, SoundRecording, Performance, Art, Electronic, dan Misc. Source.Type secara terpisah menyimpan tipe sumber sebagai string biasa. Selain Title dan ShortTitle, Source menampilkan puluhan bidang spesifik kategori sesuai kebutuhan SourceType yang dipilih – bidang buku (BookTitle, Edition, NumberVolumes, Volume, Pages, ChapterNumber), bidang periodik (JournalName, PeriodicalTitle, PublicationTitle, Issue), bidang web (InternetSiteTitle, Url, DayAccessed, MonthAccessed, YearAccessed), bidang hukum (CaseNumber, AbbreviatedCaseNumber, Court, Reporter), bidang rekaman dan siaran (AlbumTitle, Broadcaster, BroadcastTitle, RecordingNumber, Medium, ProductionCompany, Distributor, Station, Theater), PatentNumber, StandardNumber, bidang tesis (ThesisType, Institution, Department), dan bidang umum (Publisher, City, StateOrProvince, CountryOrRegion, Year, Month, Day, Comments, Guid, Doi, Version, RefOrder, Lcid).

Contributors

Source.Contributors adalah ContributorCollection dengan satu properti per peran kontributor – Author, Editor, Translator, Compiler, Composer, Conductor, Counsel, Director, Interviewee, Interviewer, Inventor, Performer, Producer, Writer, Artist, dan BookAuthor – masing-masing bertipe Contributor, basis umum untuk dua jenis kontributor yang dijelaskan di bawah.

Kontributor Individu vs. Korporat

Contributor diimplementasikan oleh dua kelas: Person (First, Middle, Last) untuk satu individu, dan Corporate (Name) untuk sebuah organisasi. PersonCollection juga diturunkan dari Contributor dan mengimplementasikan IEnumerable<Person> (Add, Remove, RemoveAt, Clear, Contains, Count), sehingga peran kontributor yang memiliki banyak penulis individu dapat diberikan PersonCollection dengan sama mudahnya seperti peran dengan satu penulis yang diberikan Person – keduanya, bersama dengan Corporate, memenuhi properti peran bertipe Contributor yang sama.

Penyajian Konten Bibliografi

Source rekaman hanya menyediakan data – mereka tidak menghasilkan teks sitasi atau bibliografi sendiri. Itu terjadi melalui FieldCitation and FieldBibliography, yang mencari sebuah Source dengan mencocokkan SourceTag against Source.Tag. Lihat panduan tautan dan referensi untuk kelas bidang tersebut.

Tips dan Praktik Terbaik

• Berikan setiap Source Tag yang unik – itu satu-satunya nilai yang FieldCitation.SourceTag dan FieldBibliography.SourceTag gunakan untuk menemukan catatan yang tepat.
• Isi hanya bidang Source yang relevan dengan SourceTypenya – misalnya sumber Book tidak memerlukan Broadcaster atau CaseNumber, namun kelas tidak menegakkan hal ini untuk Anda.
• Gunakan Person untuk satu kontributor bernama, PersonCollection untuk beberapa individu dalam peran yang sama, dan Corporate ketika kontributor adalah organisasi bukan orang – tetapkan yang sesuai ke properti peran ContributorCollection yang cocok.
• Bibliography.BibliographyStyle mencatat nama gaya sitasi yang harus diterapkan; pertahankan konsistensinya dengan cara bidang FieldCitation Anda mengharapkan output mereka diformat.
• Tambahkan setiap Source ke Document.Bibliography.Sources sebelum memperbarui bidang CITATION atau BIBLIOGRAPHY yang merujuk kepadanya – sumber yang hilang berarti bidang yang merujuk tidak memiliki apa pun untuk diselesaikan.

Masalah Umum

FAQ

Bagaimana cara menambahkan sumber buku dengan satu penulis?

Buat Source dengan SourceType.Book, atur BookTitle, Publisher, Year, dan bidang terkait, kemudian tetapkan Person ke Source.Contributors.Author.

Bagaimana cara menambahkan sumber dengan beberapa penulis?

Tetapkan sebuah PersonCollection (diisi dengan instance Person melalui Add()) ke properti peran ContributorCollection yang relevan, seperti Author.

Bagaimana cara saya mengutip sebuah organisasi alih-alih individu?

Tetapkan sebuah instance Corporate (dibuat dengan Name organisasi) ke properti peran ContributorCollection alih-alih Person atau PersonCollection.

Di mana catatan Source sebenarnya muncul dalam dokumen yang dirender?

Mereka tidak dirender sendiri – FieldCitation and FieldBibliography field menghasilkan konten yang dibangun darinya, dicocokkan oleh SourceTag. Lihat panduan tautan dan referensi.

API Reference Ringkasan

Lihat Juga

• Aspose.Words for .NET — Enterprise Documentation