وحدة:ضبط استنادي/config/شرح
![]() | صُنفت هذه الوحدة على أنها في مرحلة بيتا. عندما تصل الوحدة لهذه المرحلة، يمكن أن يوسع استخدامها في الصفحات الأخرى. لكن يجب توخي الحذر من أن الوحدات في هذه المرحلة ما زالت حديثة العهد لذلك وجب توخي الحذر عند الاستخدام وملاحظة أي أخطاء تنتج عنها. من العرف أن المجتمع سوف يوصل الوحدات في هذه المرحلة للتي بعدها عبر صفحات النقاش الخاصة بالوحدة أو أي مكان يعلن عن هذه الوحدة عبر ملاحظة أن هذه الوحدة تعمل بشكل صحيح والجميع راضٍ عن أدائها. |
صفحات متصلة |
---|
شرح يوضح بنية وحدة:ضبط استنادي.
البنية
[عدل]الصيغة لجدول p.config
هي كالتالي:
- property = معرف خاصية ويكي بيانات، بدون البادئة P.
- section = رقم القسم لوضع المعرف. انظر #قائمة الأقسام (section) للتفاصيل.
- pattern = نمط لوا لتنسيق صالح للمُعرف. لاحظ أن هذا مشابه ولكن ليس مطابقًا لـ تعبير نمطي. إذا حذف هذا، فلا تستطيع الوحدة التحقق من صلاحية المعرفات.
- link = عنوان URL للصفحة الخارجية التي تحتوي على تفاصيل المُعرف، يستبدل الرمز
$1
بالمُعرف. - label = تسمية رابط.
- remark = شرح موجز لقاعدة بيانات الضبط الاستنادي، للاستخدام في توثيق قالب:ضبط استنادي فقط.
مثال
[عدل]النص البرمجي أدناه يُولّد رابطًا إلى قاموس السيرة الذاتية الأيرلندي [الإنجليزية] في القسم 6. تُجلب بياناته من خاصية ويكي بيانات مُعرِّف قاموس تراجم الأشخاص الأيرلندي (DIB) (P6829) ويجب أن تكون المعرفات بالشكل التالي: 0، يليه 0 أو 1، يليه 4 أرقام، من الممكن أن يتبعها نقطة عشرية ثم حرف من A إلى D.
{
property = 6829,
section = 6,
pattern = '0[01]%d%d%d%d%.?[A-D]?',
link = 'https://doi.org/10.3318/dib.$1.v1',
label = 'قاموس تراجم الأشخاص الأيرلندي (DIB)',
},
متقدمة
[عدل]- patterns = إذا كانت هناك حاجة إلى أكثر من نمط لوا واحد، فاستخدم صيغة الجمع لهذا المتغير وأدرج قائمة الأنماط مفصولة بفواصل ومحاطة بأقواس معقوفة.
- prefix = بادئة ليتم تضمينها قبل الروابط. في هذه الحالة، سيتم استخدام الأرقام 1، 2، ... كعلامات وسيتم تجاهل حقل label.
- valid = اسم دالة لوا مخصصة في وحدة:ضبط استنادي/auxiliary تُستخدم لتحديد ما إذا كان المعرف صالحًا أم لا، في حالة عدم إمكانية استخدام طريقة pattern. يجب أن تعيد
false
إذا كان المعرف غير صالح. - customlink = اسم دالة لوا مخصصة في وحدة:ضبط استنادي/auxiliary والتي ستنتج الرابط الخارجي بالكامل. يجب أن تعيد
false
إذا كان المعرف غير صالح. - suppressedbyproperty = إذا كان يجب عدم عرض هذا المعرف إذا كانت المعرفات الأخرى موجودة، فحددها هنا في قائمة مفصولة بفواصل ومحاطة بأقواس معقوفة.
قائمة الأقسام (section)
[عدل]أسماء كل قسم تُعرّف بواسطة دالة p.sectionNames
.
خطأ لوا: expandTemplate: template "رابط الخاصية في ويكي بيانات" does not exist.
القوائم البيضاء
[عدل]تُعرّف القوائم البيضاء بواسطة دالة p.whitelists
. الصيغة هي كالتالي:
- code = {topic = topic QID, properties = {property PIDs}}
حيث
- code هو رمز القائمة البيضاء الذي يتم استدعاؤه عبر وسيط
|show=
. - topic QID هو معرف ويكي بيانات QID للموضوع الممثل بواسطة القائمة البيضاء، بدون البادئة Q.
- property QIDs هو قائمة مفصولة بفواصل لمعرفات PIDs للخصائص المشمولة في القائمة البيضاء (بدون البادئة P).
على سبيل المثال، تُعرّف القائمة البيضاء لإيطاليا كما يلي:
it = {topic = 38, properties = {396, 3863, 1986, 8034}},
القائمة البيضاء تحمل الرمز it
، تمثل إيطاليا (Q38) وتشمل الخصائص التالية: مُعرِّف مُؤلِّف لدى خدمة المكتبة الوطنية الإيطاليَّة (SBN) (P396), مُعرِّف البحرية الإيطالية للمنارات وأنظمة الإنذار (EF) (P3863), مُعرِّف قاموس تراجم الأشخاص الإيطالي (DBI) (P1986), مُعرِّف مكتبة الفاتيكان (VcBA) (P8034).
القوائم البيضاء المعترف بها حاليًا مدرجة أدناه:
انظر أيضا
[عدل]
![]() | هذه صفحة توثيق فرعية لوحدة:ضبط استنادي/config. قد تحتوي على معلومات الاستخدام أو تصنيفات ومحتويات أخرى، والتي لا تشكل جزءًا من صفحة الوحدة الأصلية. |