ग्रंथसूची के साथ काम करना

ग्रंथसूची के साथ कार्य करना

Word की उद्धरण और ग्रंथसूची सुविधा स्रोत डेटा को उन फ़ील्ड्स से अलग रखती है जो इसे प्रदर्शित करते हैं। Aspose.Words FOSS के लिए .NET वे मॉडल जो डेटा को … के माध्यम से स्रोत करते हैं Aspose.Words.Bibliography namespace – Source, Contributor, Person, और Corporate – से पहुँचा जा सकता है Document.Bibliography. यह पृष्ठ उस डेटा को बनाने और पढ़ने को कवर करता है; वह CITATION and BIBLIOGRAPHY फ़ील्ड्स जो इसे प्रदर्शित करते हैं, … में कवर किए गए हैं लिंक और संदर्भ गाइड.

ग्रंथसूची डेटा मॉडल

Document.Bibliography एक Bibliography इंस्टेंस है जिसमें BibliographyStyle है — उद्धरण शैली का नाम (जैसे APA या MLA) जो BIBLIOGRAPHY फ़ील्ड के अपडेट होने पर लागू होना चाहिए — और Sources, एक IList<Source> जो दस्तावेज़ में उपलब्ध प्रत्येक स्रोत रिकॉर्ड को रखता है।

स्रोत रिकॉर्ड्स

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.Type अलग से स्रोत प्रकार को साधारण स्ट्रिंग के रूप में रखता है। 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), PatentNumber, StandardNumber, थिसिस फ़ील्ड्स (ThesisType, Institution, Department), और सामान्य फ़ील्ड्स (Publisher, City, StateOrProvince, CountryOrRegion, Year, Month, Day, Comments, Guid, Doi, Version, RefOrder, Lcid)।

Contributors

Source.Contributors एक ContributorCollection है जिसमें प्रत्येक योगदानकर्ता भूमिका के लिए एक प्रॉपर्टी होती है – Author, Editor, Translator, Compiler, Composer, Conductor, Counsel, Director, Interviewee, Interviewer, Inventor, Performer, Producer, Writer, Artist, और BookAuthor – प्रत्येक को Contributor के रूप में टाइप किया गया है, जो नीचे वर्णित दो प्रकार के योगदानकर्ता के लिए सामान्य बेस है।

व्यक्तिगत vs. कॉर्पोरेट योगदानकर्ता

Contributor दो क्लासों द्वारा लागू किया गया है: Person (First, Middle, Last) एकल व्यक्ति के लिए, और Corporate (Name) एक संगठन के लिए। PersonCollection भी Contributor से व्युत्पन्न है और IEnumerable<Person> (Add, Remove, RemoveAt, Clear, Contains, Count) को लागू करता है, इसलिए कई व्यक्तिगत लेखकों वाले योगदानकर्ता भूमिका को PersonCollection इस तरह असाइन किया जा सकता है जैसे एकल लेखक वाली भूमिका को Person असाइन किया जाता है – दोनों, Corporate के साथ, समान Contributor-टाइप्ड भूमिका प्रॉपर्टी को संतुष्ट करते हैं।

ग्रंथसूची सामग्री का रेंडरिंग

Source रिकॉर्ड केवल डेटा प्रदान करते हैं – वे स्वयं उद्धरण या ग्रंथसूची पाठ नहीं बनाते। यह इसके द्वारा होता है FieldCitation and FieldBibliography, जो एक Source मेल करके SourceTag against Source.Tag. देखें लिंक और संदर्भ गाइड उन फ़ील्ड क्लासों के लिए।

टिप्स और सर्वोत्तम प्रथाएँ

• प्रत्येक Source को एक अद्वितीय Tag दें – यह वह एकमात्र मान है जिसे FieldCitation.SourceTag और FieldBibliography.SourceTag सही रिकॉर्ड खोजने के लिए उपयोग करते हैं।
• केवल उन Source फ़ील्ड को भरें जो उसके SourceType से संबंधित हैं – उदाहरण के तौर पर, एक Book स्रोत को Broadcaster या CaseNumber की कोई जरूरत नहीं होती, लेकिन क्लास आपके लिए इसे लागू नहीं करती।
• एकल नामित योगदानकर्ता के लिए Person का उपयोग करें, समान भूमिका में कई व्यक्तियों के लिए PersonCollection, और जब योगदानकर्ता व्यक्ति के बजाय एक संगठन हो तो Corporate — जो भी उपयुक्त हो उसे मिलते-जुलते ContributorCollection भूमिका गुण को सौंपें।
• Bibliography.BibliographyStyle यह रिकॉर्ड करता है कि कौन-सा उद्धरण शैली नाम लागू करना है; इसे उसी तरह रखें जैसा आपका FieldCitation फ़ील्ड अपने आउटपुट के स्वरूप की अपेक्षा करता है।
• हर Source को Document.Bibliography.Sources में जोड़ें, फिर CITATION या BIBLIOGRAPHY फ़ील्ड्स को अपडेट करें जो इसका संदर्भ देते हैं — यदि स्रोत अनुपस्थित है तो संदर्भित फ़ील्ड को हल करने के लिए कुछ नहीं मिलेगा।

सामान्य समस्याएँ

FAQ

मैं एकल लेखक वाले पुस्तक स्रोत को कैसे जोड़ूँ?

SourceType.Book के साथ एक Source बनाएं, BookTitle, Publisher, Year और संबंधित फ़ील्ड सेट करें, फिर Source.Contributors.Author को एक Person सौंपें।

मैं कई लेखकों वाले स्रोत को कैसे जोड़ूँ?

एक PersonCollection (जो Person उदाहरणों से Add() के माध्यम से भरा गया है) को संबंधित ContributorCollection भूमिका गुण में असाइन करें, जैसे Author।

मैं एक व्यक्ति के बजाय संगठन को कैसे उद्धृत करूँ?

एक Corporate उदाहरण (संगठन के Name के साथ निर्मित) को ContributorCollection भूमिका गुण में असाइन करें, Person या PersonCollection के बजाय।

रेंडर किए गए दस्तावेज़ में Source रिकॉर्ड वास्तव में कहाँ दिखाई देते हैं?

वे अपने आप रेंडर नहीं होते – FieldCitation and FieldBibliography फ़ील्ड उन पर निर्मित सामग्री को रेंडर करते हैं, जो द्वारा मेल खाती है SourceTag. देखें लिंक और रेफ़रेंस गाइड.

API Reference सारांश

यह भी देखें

• Aspose.Words for .NET — Enterprise Documentation