.NET में ग्रंथसूची के साथ कैसे काम करें

चरण 1: पैकेज स्थापित करें

Aspose.Words FOSS for .NET अभी तक कोई NuGet पैकेज प्रकाशित नहीं करता है – इसके बजाय स्रोत से लाइब्रेरी बनाएं। https://github.com/aspose-words-foss/Aspose.Words-FOSS-for-.NET.git को क्लोन करें, फिर .NET SDK के साथ रिलीज़ कॉन्फ़िगरेशन में Aspose.Words.sln बनाएं और अपने प्रोजेक्ट से उत्पन्न 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: कई या कॉर्पोरेट योगदानकर्ताओं को असाइन करें

जब किसी भूमिका में एक से अधिक व्यक्तिगत योगदानकर्ता हों, तो एक एकल Person के बजाय PersonCollection असाइन करें – 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, जो इस में कवर किया गया है लिंक और रेफ़रेंस गाइड.