Cara Bekerja dengan Bibliografi di .NET
Panduan ini menunjukkan cara membangun data sumber kutipan di balik fitur bibliografi Word di Aspose.Words FOSS untuk .NET, menggunakan Source, Contributor, Person, dan Corporate kelas dalam Aspose.Words.Bibliography namespace. Ini mencakup pembuatan catatan sumber, memilih tipe sumber yang tepat, menugaskan kontributor individu dan korporat, serta menambahkan sumber sehingga CITATION and BIBLIOGRAPHY bidang dapat menafsirkannya.
Panduan Langkah-demi-Langkah
Langkah 1: Instal Paket
Aspose.Words FOSS for .NET belum menerbitkan paket NuGet – bangun pustaka dari sumbernya saja. Klon https://github.com/aspose-words-foss/Aspose.Words-FOSS-for-.NET.git, lalu bangun Aspose.Words.sln dalam konfigurasi Release dengan SDK .NET dan referensikan assembly Aspose.Words yang dihasilkan dari proyek Anda. Pustaka ini menargetkan .NET Standard 2.0, sehingga dapat dijalankan pada .NET Framework 4.6.2+ dan .NET 6/8/10.
Langkah 2: Impor Kelas yang Diperlukan
Tambahkan direktif using Aspose.Words; untuk Document, dan direktif using Aspose.Words.Bibliography; untuk Source, SourceType, Contributor, ContributorCollection, Person, PersonCollection, dan Corporate.
Langkah 3: Akses Data Bibliografi Dokumen
Document.Bibliography mengembalikan sebuah instance Bibliography. Properti Sources-nya adalah sebuah IList<Source> yang berisi setiap catatan sumber yang tersedia untuk dokumen, dan BibliographyStyle mencatat nama gaya sitasi — misalnya APA atau MLA — yang harus diterapkan ketika bidang BIBLIOGRAPHY diperbarui.
Langkah 4: Buat Catatan Sumber
Bangun sebuah Source dengan Source(tag, sourceType): Tag adalah pengidentifikasi singkat yang FieldCitation.SourceTag dan FieldBibliography.SourceTag cocokkan nanti, dan SourceType adalah nilai enum yang mengidentifikasi jenis sumber — Book, BookSection, JournalArticle, ArticleInAPeriodical, ConferenceProceedings, Report, Patent, Case, InternetSite, DocumentFromInternetSite, Interview, Film, SoundRecording, Performance, Art, Electronic, atau Misc. Berikan setiap Source sebuah Tag yang unik — itu adalah satu-satunya nilai yang digunakan bidang sitasi untuk menemukan catatan yang tepat.
Langkah 5: Isi Kolom untuk Jenis Sumber yang Dipilih
Selain Title dan ShortTitle, Source menampilkan puluhan kolom khusus kategori — isi hanya kolom yang relevan dengan SourceType yang dipilih. Sumber buku menggunakan BookTitle, Edition, NumberVolumes, Volume, Pages, dan ChapterNumber. Sumber periodik menggunakan JournalName, PeriodicalTitle, PublicationTitle, dan Issue. Sumber web menggunakan InternetSiteTitle, Url, DayAccessed, MonthAccessed, dan YearAccessed. Sumber hukum menggunakan CaseNumber, AbbreviatedCaseNumber, Court, dan Reporter. Sumber rekaman dan siaran menggunakan AlbumTitle, Broadcaster, BroadcastTitle, RecordingNumber, Medium, ProductionCompany, Distributor, Station, dan Theater. Kolom tujuan umum berlaku pada kebanyakan jenis sumber: Publisher, City, StateOrProvince, CountryOrRegion, Year, Month, Day, Comments, Guid, Doi, Version, RefOrder, dan Lcid.
Langkah 6: Tetapkan Kontributor Individu
Source.Contributors mengembalikan sebuah 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 kelas dasar abstrak Contributor. Tetapkan sebuah Person (dibuat dari Last, First, Middle) ke properti peran untuk satu individu yang bernama.
Langkah 7: Tetapkan Kontributor Ganda atau Korporat
Ketika sebuah peran memiliki lebih dari satu kontributor individu, tetapkan PersonCollection alih-alih Person tunggal – PersonCollection juga berasal dari Contributor dan mengimplementasikan IEnumerable<Person>, dengan Add(), Remove(), RemoveAt(), Clear(), Contains(), dan Count untuk mengelola anggotanya. Ketika kontributor adalah organisasi bukan orang, tetapkan Corporate (dibangun dari Name) ke properti peran sebagai gantinya. Person, PersonCollection, dan Corporate semuanya memenuhi properti peran bertipe Contributor, jadi pilih yang paling sesuai dengan sumber.
Langkah 8: Tambahkan Sumber Agar Bidang Sitasi Dapat Menyelesaikannya
Tambahkan setiap yang selesai Source to Document.Bibliography.Sources sebelum memperbarui apa pun CITATION or BIBLIOGRAPHY field yang merujuk kepadanya — sumber yang dibangun tetapi tidak pernah ditambahkan tidak memiliki apa pun bagi field yang merujuk untuk diselesaikan. Source record hanya menyediakan data; mereka tidak menghasilkan teks kutipan atau bibliografi sendiri. Rendering terjadi melalui FieldCitation and FieldBibliography, yang dibahas dalam the panduan tautan dan referensi.
Masalah Umum dan Solusi
Sebuah field CITATION atau BIBLIOGRAPHY tidak dapat diselesaikan The Source.Tag tidak persis cocok dengan field SourceTag. Pastikan tag cocok, dan bahwa Source sebenarnya ditambahkan ke Document.Bibliography.Sources.
Tipe kontributor salah ditetapkan ke peran Sebuah Person ditetapkan di mana ada banyak kontributor, atau sebaliknya. Gunakan PersonCollection untuk beberapa individu dalam satu peran, Person untuk satu individu, dan Corporate untuk sebuah organisasi.
Bidang Sumber terlihat tidak konsisten untuk tipenya Bidang untuk yang berbeda SourceType telah diisi – misalnya, bidang web seperti Url and DayAccessed ditetapkan pada sebuah Book sumber. Isi hanya bidang yang relevan dengan yang dipilih SourceType.
Sebuah sumber dengan banyak penulis hanya menampilkan satu nama Satu Person ditetapkan ke Author daripada sebuah PersonCollection. Buat sebuah PersonCollection, tambahkan setiap Person with Add(), dan tetapkan koleksi ke properti role.
BibliographyStyle tidak cocok dengan format sitasi yang saya harapkan Bibliography.BibliographyStyle mencatat nama gaya sitasi yang harus diterapkan – tetap konsisten dengan cara dokumen FieldCitation field-field mengharapkan output mereka diformat.
Pertanyaan yang Sering Diajukan
Bagaimana cara menambahkan sumber buku dengan satu penulis?
Buat sebuah Source dengan SourceType.Book, atur BookTitle, Publisher, Year, dan field terkait, lalu tetapkan sebuah Person ke Source.Contributors.Author.
Bagaimana cara menambahkan sumber dengan banyak penulis?
Tetapkan sebuah PersonCollection – diisi dengan instance Person melalui Add() – ke properti peran ContributorCollection yang relevan, seperti Author.
Bagaimana cara saya mengutip sebuah organisasi daripada individu?
Tetapkan sebuah instance Corporate, yang dibangun 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 merender konten yang dibangun dari mereka, cocok dengan SourceTag. Lihat panduan tautan dan referensi.
Apa yang mengidentifikasi sebuah catatan Source bagi bidang-bidang yang mengutipnya?
Source.Tag, yang diatur di konstruktor Source(tag, sourceType) – FieldCitation.SourceTag dan FieldBibliography.SourceTag mencocokkan nilai tepat ini.
