مودول:Wikidata2/شرح

من ويكيپيديا

هذه صفحة توثيق لمودول:Wikidata2


هذه الوحدة نسخت في البداية من sv:Modul:Wikidata2 ومن ثم تم تطويرها هنا.

الاستخدامات[بدل لكود]

أنظر قائمة قوالب تستخدم هذه الوحدة.

الوحدات الفرعية[بدل لكود]

الاستعمال[بدل لكود]

مثال

{{#invoke:Wikidata2|formatStatements|property=p17}}


انقر لإظهار الشرح >>>>

الوسائط[بدل لكود]

formatStatements[بدل لكود]

موضيل:طالع

  • |property= مطلوب الخاصية المطلوبة.
  • |entityId= أو |id= معرف عنصر ويكي بيانات.
  • |page= يمكن إستخدامه بدلاً من |entityId=Q805 كالتالي: |page=اليمن .
  • |enbarten= أو |firstvalue= يعرض أول قيمة فقط في الخاصية.
    • |firstvalue=2 يعرض القيمة الثانية في الخاصية إن كانت موجودة، يمكن استخدام هذا الخيار حتى رقم 9.
  • |numval= يعرض عدد محدد من القيم في الخاصية.
    • |numval=4 يعرض القيم الأربع الأولى في الخاصية إن كانت موجودة.
  • |prefix= بادئة
  • |suffix= لاحقة
  • |formatting= يحدد تنسيق القيم يستخدم مع إحداثيات جغرافية، وعنصر، وخاصية.
  • |label= اذا كنت تريد الاختيار كيفية ظهور الوصلات. مثلا [[شعار مقاطعة بليكينج|الشعار]] يمكن الحصول عليها عن طريق اضافة |label=الشعار تؤثر هذه المعلمة على وحدات القياس.
  • |raw= يعود بالنتيجة خام على شكل جداول (يستخدم من داخل وحدات لوا أخرى) ويمكن معاينة ما سيكون الناتج عليه عبر إضافة خيار |rawtolua=.
فصل القيم[بدل لكود]
  • |separator= فاصلة بين البنود | انظر أيضا conjunction
  • |conjunction= الفاصلة الأخيرة قبل اخر بند، افتراضي ، و .

خطأ: لا توجد وحدة بهذا الاسم "DemoTemplate3".

|separator=br يضع القيم في أسطر. |separator=* يضع القيم في قائمة نقطية.

خطأ: لا توجد وحدة بهذا الاسم "DemoTemplate3".

خطأ: لا توجد وحدة بهذا الاسم "DemoTemplate3".

التحديد والإزاحة[بدل لكود]
|limit= |offset=
  • يُستخدم وسيط |limit= لتحديد عدد القيم التي يتم العمل عليها، (ملاحظة: قد تظهر عدد القيم كما حددتها أو أقل بناءًا على عوامل تصفية وتحديد أخرى)
    • مثال عند وضع |limit=4:
    • خطأ: لا توجد وحدة بهذا الاسم "DemoTemplate3".
  • يُستخدم وسيط |offset= لتحديد عدد القيم التي يتم تخطيها بدءًا من القيمة 1.
    • مثال عند وضع |offset=3:
    • خطأ: لا توجد وحدة بهذا الاسم "DemoTemplate3".
تحديد عدد القيم[بدل لكود]
  • |numval=2 عدد القيم المراد عرضها

خطأ: لا توجد وحدة بهذا الاسم "DemoTemplate3".

رتبة القيم / rank[بدل لكود]

موضيل:طالع

  • |rank= يحدد نوع البيانات المطلوب عرضها:
    • |rank=all يظهر جميع البنود في الخاصية.
    • |rank=valid يظهر البنود المفضلة والتي بوضع "ترتيب عادي" ولكن لا يظهر المهملة.
    • |rank=best (افتراضي) يظهر القيم المفضلة.
ترتيب النتيجة / sort[بدل لكود]
  • |sortingproperty= تحديد خاصية الترتيب.
  • تستخدم وسائط الترتيب (|sortbytime=، و|sortbynumber=، و|sortingmethod=) قيمتين فقط كالتالي:
  • chronological = تصاعدي (ASC): من التاريخ الأقدم إلى التاريخ الأحدث (إذا كانت الخاصية المحددة تاريخ)
  • inverted = تنازلي (DESC): من التاريخ الأحدث إلى التاريخ الأقدم (إذا كانت الخاصية المحددة تاريخ)
حسب التصفيات[بدل لكود]
  • |sortbytime= تُستخدم للترتيب النتيجة حسب التصفيات من فئة الزمن، ويتم الترتيب حسب الخواص التالية (موضيل:P، موضيل:P، موضيل:P، موضيل:P، موضيل:P، موضيل:P).
  • إذا أردنا تحديد خاصية الترتيب نستخدم |sortbynumber= بأحدى القيمتين أعلاه ونستخدم |sortingproperty= مع الخاصية المطلوبة.
حسب الخواص[بدل لكود]

إذا لم توجد تصفيات في النتيجة فإننا بحاجة للدخول إلى العناصر وأخذ قيمة مُعينة لجعلها مفتاح للترتيب، مثل تاريخ الولادة، أو تاريخ البدء.

  • نستخدم |sortingmethod= بأحدى القيمتين (chronological أو inverted) ونستخدم الخاصية المطلوبة عبر وسيط |sortingproperty=.

خطأ: لا توجد وحدة بهذا الاسم "DemoTemplate3".

خطأ: لا توجد وحدة بهذا الاسم "DemoTemplate3".

المراجع / References / Sources[بدل لكود]

موضيل:طالع

  • |noref= أدخل قيمة في هذه المعلمة إذا كنت لا تريد جلب المصادر من ويكي بيانات.
  • |justref= أدخل قيمة في هذه المعلمة إذا كنت تريد جلب المصادر فقط دون ظهور القيمة!.
  • |onlyvaluewithref= لإظهار البيانات التي لها مراجع فقط.
  • |numberofreferences= لوضع حد أقصى للمراجع لكل قيمة، مثلاً عند تحديد |numberofreferences=1 يظهر مرجع واحد فقط في كل قيمة إن كان متوفراً.
صياغة النص[بدل لكود]
  • |formatcharacters= تحديد صيغة اخراج القيمة، القيم المسموح بها هي: lc/uc/lcfirst/ucfirst/formatnum
    • |formatcharacters=lc: تحويل جميع أحرف النص الإنجليزي إلى حروف صغيرة.
    • |formatcharacters=lcfirst: تحويل الحرف الأول من النص الإنجليزي إلى حرف صغير.
    • |formatcharacters=uc : تحويل جميع أحرف النص الإنجليزي إلى حروف كبيرة.
    • |formatcharacters=ucfirst: تحويل الحرف الأول من النص الإنجليزي إلى حرف كبير.
    • |formatcharacters=formatnum: مشروحة في #كمية.
تصفيات / Qualifiers[بدل لكود]

موضيل:طالع

  • |withdate= يضيف تصفية موضيل:P إذا كانت موجودة.
  • |bothdates= يضيف تصفيات موضيل:P وموضيل:P إذا كانتا موجودتان كلاهما أو إحداهما.
    • |bothdates=line يضع سطر جديد قبل التاريخ، |bothdates=before يضع التاريخ قبل القيمة، |bothdates=after يضع التاريخ بعد القيمة.
  • |qual1= يضيف تصفية محددة.
    • |qual1=P1545 يضيف تصفية موضيل:P الى بنود الخاصية، مثال:منصب باراك أوباما + ترتيبه:
      • {{#invoke:Wikidata2{{#تبديل:{{SUBPAGENAME}}|ملعب=/ملعب}} |formatStatements|entityId=Q76|property=P39|qual1=P1545|noref=true|rank=best}} ينتج :← رئيس الولايات المتحدة (44)
فلترة النتائج[بدل لكود]
  • |avoidqualifier= يتجاهل القيم التي تحتوي تصفيات معينة، مثل: |avoidqualifier=P518 يظهر البند الذي لا يحتوي على تصفية موضيل:P.
    • بإستخدام |avoidqualifiervalue= مع |avoidqualifier= فإن ذلك يحدد قيمة التصفية إذا طابقت الوسيط |avoidqualifiervalue= فلن يتم إظهارها، وإذا لم تطابق فسيتم إظهارها، يدعم حالياً العناصر/items فقط.
  • |preferqualifier= تحديد خاصية تصفيات يجب أن تكون بيانات الخاصية متضمنتها.
    • |preferqualifiervalue= تحدد القيمة التي تناسب أعلاه. يدعم حالياً العناصر فقط.
  • |justthisqual= يظهر فقط التصفية، إذا لم تكن التصفية موجودة لن يظهر شيء.
وسائط حسب نوع البيانات / datatype[بدل لكود]
عنصر / item[بدل لكود]

موضيل:طالع

  • |nolink= يظهر النتيجة دون وصلات.
  • |formatting=raw يعرض القيمة بشكل Q505.
  • |formatting=sitelink يعرض القيم التي تحتوي مقالة في ويكيبيديا العربية.
= فلترة النتيجة =[بدل لكود]
  • |getonly= يستخدم هذا الوسيط إذا أردنا الحصول على عناصر معينة التي تكون قيمة موضيل:P فيها تساوي قيمة هذا الوسيط، مثال:
    • |getonly=Q5 للحصول على الأفراد فقط.
    • القيم المتعددة ممكنة، مثل :|getonly=Q127448,Q193556 للحصول على البلديات السويدية والمناظر الطبيعية.
  • |getonlyproperty= إذا أردنا استخدام خاصية أخرى بدلاً من موضيل:P في البند السابق.
  • |avoidvalue= يستخدم هذا الوسيط إذا أردنا أن نتجاهل أو نلغي ظهور عنصر معين، مثال عند وضع |avoidvalue=Q21769847 فتظهر النتائج دون ظهور موضيل:Q.
= prefervalue =[بدل لكود]
  • |prefervalue= يستخدم هذا الوسيط بشكل معاكس للوسيط |avoidvalue= حيث نقوم بتحديد القيمة التي نريد ظهورها |prefervalue=Q19481 فتظهر النتيجة للعنصر موضيل:Q فقط، ولكن الفائدة من إستخدام هذا الوسيط هي التأكد من وجود العنصر في هذه الخاصية أو للحصول على التصفيات، مثال يظهر عناصر موضيل:P مع تصفية موضيل:P بين قوسين.

خطأ: لا توجد وحدة بهذا الاسم "DemoTemplate3".

إذا كنا قد حصلنا عبر خاصية موضيل:P عن الفريق الفائز في موضيل:Q. وأردنا الحصول على عدد مرات الفوز للفريق الفائز، من الجدول السابق ويتم ذلك بإستخدام الوسيط |justthisqual= ما ينتج: خطأ: لا توجد وحدة بهذا الاسم "DemoTemplate3".

ولكننا نريد ظهور التصفية للفريق الفائز فقط وهو موضيل:Q:

خطأ: لا توجد وحدة بهذا الاسم "DemoTemplate3".

خطأ: لا توجد وحدة بهذا الاسم "DemoTemplate3".

= avoidvalue =[بدل لكود]
  • |avoidvalue= يستخدم هذا الوسيط بشكل معاكس للوسيط |prefervalue= إذا أردنا أن نتجاهل أو نلغي ظهور عنصر معين، مثال عند وضع |avoidvalue=Q50602 فتظهر النتائج دون ظهور موضيل:Q.

خطأ: لا توجد وحدة بهذا الاسم "DemoTemplate3".

وسيط property1[بدل لكود]
  • يستخدم للحصول على قيمة خاصية من العناصر التي حصلنا عليها، بحيث تظهر قيمة |property1= بجانب القيمة الأصلية:

خطأ: لا توجد وحدة بهذا الاسم "DemoTemplate2".

وسيط property2[بدل لكود]
  • مثل |property1= (بدون استخدام |property3=).

خطأ: لا توجد وحدة بهذا الاسم "DemoTemplate2".

وسيط property3[بدل لكود]
  • يستخدم بجانب الوسيط |property2=، بحيث تظهر قيمة |property3= بدون قيمة |property2=.

خطأ: لا توجد وحدة بهذا الاسم "DemoTemplate2".

مع وسيط |image=t

خطأ: لا توجد وحدة بهذا الاسم "DemoTemplate2".

ملف وسائط من كومنز / commonsMedia[بدل لكود]
  • تظهر الصور افتراضياً كالتالي:
    • {{#invoke:Wikidata2|formatStatements|entityId=Q76|property=P18|noref=true|rank=best}} → President Barack Obama.jpg
  • |image= عند استخدام هذا الوسيط في خواص الصور تظهر الصورة مباشرة.
|size= لتحديد حجم الصورة (60 افتراضياً)، ضع القيمة دون (بك/px إلخ). |center= لجعل الصورة في الوسط ضع قيمة هذا الخيار |center=yes.

خطأ: لا توجد وحدة بهذا الاسم "DemoTemplate3".

خطأ: لا توجد وحدة بهذا الاسم "DemoTemplate3".
إحداثيات جغرافية / coordinate[بدل لكود]

خطأ: لا توجد وحدة بهذا الاسم "DemoTemplate4".

  • |formatting=latitude يعرض خط العرض فقط.
  • |formatting=longitude يعرض خط الطول فقط.
  • |formatting=precision يعرض الدقة.

خطأ: لا توجد وحدة بهذا الاسم "DemoTemplate4".

خطأ: لا توجد وحدة بهذا الاسم "DemoTemplate4".


نص أحادي اللغة / نص بلغة وحيدة / monolingualtext[بدل لكود]

موضيل:طالع

  • |langpref= في الوحدة، هناك مرشح يعطي أولوية للقيم التي تحتوي على "اللغة = العربية". أضف القيمة المطلوبة لتعطيل هذا الفلتر.
    • القيم المقبولة الأخرى هي : justlang و langcode
|langpref=justlang لإظهار لغة النص فقط دون النص، مثل الإنجليزية. |langpref=langcode لإظهار رمز لغة النص فقط دون النص، مثل en.

خطأ: لا توجد وحدة بهذا الاسم "DemoTemplate4".

خطأ: لا توجد وحدة بهذا الاسم "DemoTemplate4".

|showlang= |textformat=text
استخدم أي قيمة لإظهار النص حسب تنسيق موضيل:رمز لغة واسمها. اظهار النص فقط دون استخدام قوالب {{رمز لغة واسمها}} أو {{رمز لغة}}

خطأ: لا توجد وحدة بهذا الاسم "DemoTemplate3".

خطأ: لا توجد وحدة بهذا الاسم "DemoTemplate3".

كمية / quantity[بدل لكود]
  • الافتراضي:
    • {{#invoke:Wikidata2|formatStatements|entityId=Q805|property=P2046|noref=t|firstvalue=y}} → 555000 كيلومتر مربع
|nounit= لا يظهر وحدة القياس. |formatcharacters=formatnum: تنسيق الأرقام بالفواصل.

خطأ: لا توجد وحدة بهذا الاسم "DemoTemplate4".

خطأ: لا توجد وحدة بهذا الاسم "DemoTemplate4".

  • |unitshort= يظهر وحدات القياس مختصرة. مثلاً كم بدلاً عن كيلومتر.
مثال لاستخدام |unitshort= ومثال عند عدم استخدامه:

خطأ: لا توجد وحدة بهذا الاسم "DemoTemplate4".

خطأ: لا توجد وحدة بهذا الاسم "DemoTemplate4".

نص / string[بدل لكود]
  • |stringpattern= تنسيق النص في قالب أو وصلة أو ماشابه يتم استبدال القيمة بـ$1. مثل |pattern= لكن هنا تستخدم مع نوع البيانات string.

خطأ: لا توجد وحدة بهذا الاسم "DemoTemplate3".

نقطة زمنية / time[بدل لكود]
  • |modifytime= يحدد تنسيق الوقت أو التاريخ:
    • |modifytime=longdate يكتب التاريخ في شكل "30 مارس 2024"
    • |modifytime=Y يكتب التاريخ في شكل "2024" يظهر فقط السنة.
    • |modifytime= F يكتب التاريخ في شكل "مارس" يظهر فقط الشهر.
    • |modifytime= j يكتب التاريخ في شكل "30" يظهر فقط اليوم.
  • |modifyqualifiertime= تنسيق التاريخ على النحو الوارد أعلاه، ولكن يؤثر فقط على التصفيات. qualifier
معرف خارجي / external-id[بدل لكود]

خطأ: لا توجد وحدة بهذا الاسم "DemoTemplate2".

  • |pattern= طريقة عرض الخاصية مثلاً في وصلات الضبط الاستنادي $1 مثلاً: <nowiki>https://viaf.org/viaf/$1/</nowiki> .
  • |pattern=autourl من خواص البند أعلاه، لنمط مستخدم في الخاصية موضيل:P (تنسيق عنوان URL) للخاصية المطلوبة.

خطأ: لا توجد وحدة بهذا الاسم "DemoTemplate2".


  • |pattern=autourl2 كما سبق، يقدم وصلة من نوع <nowiki>[https://viaf.org/viaf/$1/ $1] </nowiki>

خطأ: لا توجد وحدة بهذا الاسم "DemoTemplate2".

المسار / url[بدل لكود]
  • |urllabel= وضع تسمية لتظهر بدلاً من الوصلة، كما في معرف خارجي ولكن في خواص الروابط.

خطأ: لا توجد وحدة بهذا الاسم "DemoTemplate3".

خطأ: لا توجد وحدة بهذا الاسم "DemoTemplate3".

  • |displayformat= يقبل حالياً قيمة واحدة وهي |displayformat=weblink لاستخدام مودول:weblink لعرض وصلة الموقع.

{{#invoke:Wikidata2|formatStatements|entityId=Q76|property=P856|displayformat=weblink}}خطأ لوا ف package.lua على السطر 80: module 'Module:Cite' not found.


خيارات إضافية[بدل لكود]
  • |NosValue= يستخدم لإظهار نتيجة ما عند عدم وجود قيمة محلية في وسيط |value= وعدم وجود قيمة في ويكي بيانات.
property-(module/function) و claim-(module/function) و value-(module/function)[بدل لكود]

يتم دعم ثلاثة أنواع من معلمات الوظائف، والتي تشير أيضًا إلى كيفية تنسيق القيم:

  • |-module= عنوان الوحدة
  • |-function= عنوان الوظيفة
property[بدل لكود]

موضيل:ي

  • |property-module= عنوان الوحدة مثل |property-module=وحدة:Wikidata2/P54
  • |property-function= عنوان الوظيفة مثل |property-function=foot
  • تستخدم هذه الخيارات عند الحاجة لتنسيق قيم الخاصية بشكل كامل مثلاً لوضعها في جدول معين، أو فرزها بتنسيق خاص، مع إمكانية الحصول على التصفيات/qualifiers والمراجع/references وتنسيقها والتحكم بها.
  • أمثلة:
    • الوحدة مودول:Wikidata2/P54 الخاصة بعرض فرق لاعبي كرة القدم، مثل أندية كرة القدم حيث يتم فصل المنتخبات عن الأندية.
claim[بدل لكود]

موضيل:ي

  • |claim-module= عنوان الوحدة مثل |claim-module=وحدة:Wikidata2/P39
  • |claim-function= عنوان الوظيفة مثل |claim-function=office3
  • تستخدم هذه الخيارات عند الحاجة لتنسيق قيم الخاصية بشكل منفرد، مع إمكانية الحصول على التصفيات/qualifiers والمراجع/references وتنسيقها والتحكم بها.
  • أمثلة:
value[بدل لكود]

موضيل:ي

  • |value-module= عنوان الوحدة مثل |value-module=وحدة:Wikidata2/P106
  • |value-function= عنوان الوظيفة مثل |value-function=formatEntityWithGenderClaim
  • تستخدم هذه الخيارات عند الحاجة لتنسيق قيم الخاصية بشكل منفرد لكل قيمة مثلاً لأخذ تسمية الإناث عند إستخدام خاصية موضيل:P، لا نستطيع هنا الحصول على التصفيات/qualifiers والمراجع/references.
بدون استخدام |value-module= باستخدام |value-module=

خطأ: لا توجد وحدة بهذا الاسم "DemoTemplate4".

خطأ: لا توجد وحدة بهذا الاسم "DemoTemplate4".

pageId[بدل لكود]

ينتج عنصر ويكي بيانات للصفحة المستخدم فيها الكود.

خطأ: لا توجد وحدة بهذا الاسم "DemoTemplate3".

labelIn[بدل لكود]

موضيل:طالع

مثال: خطأ: لا توجد وحدة بهذا الاسم "DemoTemplate3".

descriptionIn[بدل لكود]

موضيل:طالع

مثال: خطأ: لا توجد وحدة بهذا الاسم "DemoTemplate3".

getSiteLink / وصلات المواقع[بدل لكود]

موضيل:طالع

  • |2= أو |site= الموقع مثل موضيل:مونو.
  • يتم أخذ عنصر ويكي بيانات من أحد الوسائط التالية:
    1. |1= أو |id= عنصر ويكي بيانات.
    2. |page= يمكن استخدام اسم الصفحة في هذه الويكي بدلاً من استخدام الوسيط |id=.
  • |countsitelinks= يستخدم فقط لإظهار عدد وصلات اللغات.

مثال: خطأ: لا توجد وحدة بهذا الاسم "DemoTemplate3".

مثال: خطأ: لا توجد وحدة بهذا الاسم "DemoTemplate3". أو: خطأ: لا توجد وحدة بهذا الاسم "DemoTemplate3".

أو: {{#invoke:Wikidata2|getSiteLink|page=اليمن|site=enwiki}}

Dump[بدل لكود]

مثال: {{#invoke:Wikidata2{{#تبديل:{{SUBPAGENAME}}|ملعب=/ملعب}} |Dump|claims|P19}}

مثال2: {{#invoke:Wikidata2{{#تبديل:{{SUBPAGENAME}}|ملعب=/ملعب}} |Dump|id=Q76|claims|P19}}
مثال موسع: {{#invoke:Wikidata2{{#تبديل:{{SUBPAGENAME}}|ملعب=/ملعب}} |Dump|claims|P1791|1|references|1|snaks|P244|1|datavalue|value}}

isSubclass / نوع فرعي من[بدل لكود]

إن كانت قيمة موضيل:P أو موضيل:P للصفحة التي وضع فيها الكود أو للصفحة في الوسيط |id= مساوية للوسيط |parent= ينتج 'true' غير ذلك لا ينتج شيئاً. كامل الخيارات:{{#invoke:Wikidata2{{#تبديل:{{SUBPAGENAME}}|ملعب=/ملعب}} |isSubclass|parent=|maxDepth=1|property=|id=|exitItem=}}

  • مطلوب: |parent= مثلاً موضيل:Q
  • |maxDepth= عمق البحث في الصفحات.
  • |property= الخاصية المطلوبه (افتراضياً موضيل:P، وموضيل:P)
  • |id= الصفحة المطلوب البحث فيها.
  • |exitItem=

مثال: {{#invoke:Wikidata2|isSubclass|maxDepth=1|id=Q76|parent=Q5}} → true

{{#invoke:Wikidata2|isSubclass|maxDepth=5|id=Q76|parent=Q45}}

EntityIdForTitle[بدل لكود]

يعطي معرف ويكي بيانات من خلال عنوان مقالة ويكيبيديا العربية:

  • {{#invoke:Wikidata2|EntityIdForTitle|اليمن}}
  • {{#invoke:Wikidata2|EntityIdForTitle|وحدة:Wikidata2}} → Q24575438

Qidfortitleandwiki[بدل لكود]

  • يمكن استخدام الوظيفة للحصول على معرف ويكي بيانات لصفحات في الموسوعات الأخرى:

خطأ: لا توجد وحدة بهذا الاسم "DemoTemplate3".

آخر التحديثات[بدل لكود]