كيفية العمل مع المراجع في .NET
هذا الدليل يوضح كيفية بناء بيانات مصدر الاستشهاد خلف ميزة الببليوغرافيا في Word Aspose.Words FOSS لـ .NET, باستخدام Source, Contributor, Person، و Corporate الفئات في Aspose.Words.Bibliography مساحة الأسماء. يغطي إنشاء سجلات المصدر، اختيار نوع المصدر المناسب، تعيين المساهمين الفرديين والشركات، وإضافة المصادر بحيث CITATION and BIBLIOGRAPHY يمكن للحقول حلّها.
دليل خطوة بخطوة
الخطوة 1: تثبيت الحزمة
Aspose.Words FOSS for .NET لا ينشر حزمة NuGet بعد – قم ببناء المكتبة من المصدر بدلاً من ذلك. استنسخ https://github.com/aspose-words-foss/Aspose.Words-FOSS-for-.NET.git، ثم ابنِ Aspose.Words.sln في تكوين Release باستخدام مجموعة تطوير .NET SDK وأشر إلى التجميع 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 هي قيمة تعداد تحدد نوع المصدر — 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: تعيين مساهمين متعددين أو مؤسسيين
عندما يكون للدور أكثر من مساهم فردي واحد، عيّن PersonCollection بدلاً من Person واحد – 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، مغطاة في الـ دليل الروابط والمراجع.
المشكلات الشائعة والحلول
حقل CITATION أو BIBLIOGRAPHY لا يتم حله الـ Source.Tag لا يتطابق تمامًا مع حقل SourceTag. تأكد من تطابق العلامات، وأن الـ Source تم إضافتها فعليًا إلى Document.Bibliography.Sources.
تم تعيين نوع المساهم غير الصحيح إلى دور أ Person تم تعيينه حيث يوجد مساهمون متعددون، أو العكس. استخدم PersonCollection لعدة أفراد في دور واحد، Person لفرد واحد، و Corporate لمنظمة.
حقول المصدر تبدو غير متسقة مع نوعها حقول لـ مختلف SourceType تم تعبئتها — على سبيل المثال، حقول الويب مثل Url and DayAccessed مُعينة على Book المصدر. قم بملء الحقول ذات الصلة فقط بالاختيار SourceType.
المصدر الذي يحتوي على عدة مؤلفين يعرض اسمًا واحدًا فقط واحد Person تم تعيينه إلى Author بدلاً من PersonCollection. أنشئ PersonCollection، أضف كل Person with Add()، وعيّن المجموعة إلى خاصية الدور.
BibliographyStyle لا يتطابق مع تنسيق الاستشهاد الذي أتوقعه Bibliography.BibliographyStyle يسجل اسم نمط الاستشهاد الذي يجب تطبيقه – حافظ على اتساقه مع طريقة المستند FieldCitation الحقول تتوقع تنسيق مخرجاتها.
الأسئلة المتكررة
كيف أضيف مصدر كتاب بمؤلف واحد؟
أنشئ Source مع SourceType.Book، اضبط BookTitle، Publisher، Year، والحقول ذات الصلة، ثم عيّن Person إلى Source.Contributors.Author.
كيف أضيف مصدرًا يحتوي على عدة مؤلفين؟
عيّن PersonCollection – المملوء بـ Person عبر Add() – إلى خاصية الدور ContributorCollection ذات الصلة، مثل Author.
كيف أستشهد بمنظمة بدلاً من فرد؟
قم بتعيين كائن Corporate، مُنشأ باستخدام Name الخاصة بالمنظمة، إلى خاصية الدور ContributorCollection بدلاً من Person أو PersonCollection.
أين تظهر سجلات المصدر فعليًا في المستند المُعَرض؟
لا يتم عرضهم بمفردهم – FieldCitation and FieldBibliography الحقول تعرض محتوى مبنيًا منها، يتم مطابقته بواسطة SourceTag. انظر دليل الروابط والمراجع.
ما الذي يحدد سجل المصدر للحقول التي تستشهد به؟
Source.Tag، يتم ضبطه في مُنشئ Source(tag, sourceType) – FieldCitation.SourceTag وFieldBibliography.SourceTag يتطابقان مع هذه القيمة بالضبط.
