العمل مع الببليوغرافيا

العمل مع الببليوغرافيا

تخزن ميزة الاستشهاد والببليوغرافيا في Word بيانات المصدر الخاصة بها بشكل منفصل عن الحقول التي تعرضها. Aspose.Words FOSS لـ .NET نماذج تستخرج البيانات عبر Aspose.Words.Bibliography مساحة الاسم – 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 هو تعداد يحدد نوع المصدر — القيم تشمل 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، القاعدة المشتركة لنوعي المساهم الموصوفين أدناه.

المساهمون الفرديون مقابل المساهمون المؤسسون

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

كيف أضيف مصدر كتاب بمؤلف واحد؟

أنشئ Source باستخدام SourceType.Book، واضبط BookTitle وPublisher وYear والحقول المتعلقة، ثم عيّن Person إلى Source.Contributors.Author.

كيف أضيف مصدرًا بعدة مؤلفين؟

عيّن PersonCollection (المُعبأة بـ Person عبر Add()) إلى خاصية الدور ContributorCollection ذات الصلة، مثل Author.

كيف أستشهد بمنظمة بدلاً من فرد؟

عيّن مثيل Corporate (المُنشأ باستخدام Name الخاصة بالمنظمة) إلى خاصية الدور ContributorCollection بدلاً من Person أو PersonCollection.

أين تظهر سجلات Source فعليًا في المستند المُعرض؟

لا يتم عرضها بمفردها – FieldCitation and FieldBibliography الحقول تعرض محتوى مبني عليها، يتم مطابقة ذلك بواسطة SourceTag. انظر الـ دليل الروابط والمراجع.

API Reference ملخص

انظر أيضاً

• Aspose.Words for .NET — Enterprise Documentation