وحدة:Wikidata/شرح

من ويكيبيديا، الموسوعه الحره

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

هذه الوحدة نسخت في البداية من 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= الفاصلة الأخيرة قبل اخر بند، افتراضي ، و .
القيم الافتراضية
توصيف يظهر
{{#invoke:Wikidata2|formatStatements|entityId=Q76|property=P106|rank=all}} 


  • |separator=br يضع القيم في أسطر.
القيم الافتراضية
توصيف يظهر
{{#invoke:Wikidata2|formatStatements|entityId=Q76|property=P106|rank=all|separator=br}} 
  • |separator=* يضع القيم في قائمة نقطية.
توصيف يظهر
{{#invoke:Wikidata2|formatStatements|entityId=Q76|property=P106|rank=all|separator=*}} 


  • |separator=# يضع القيم في قائمة رقمية.
توصيف يظهر
{{#invoke:Wikidata2|formatStatements|entityId=Q76|property=P106|rank=all|separator=#}} 


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

  • |rank= يحدد نوع البيانات المطلوب عرضها:
    • |rank=all يظهر جميع البنود في الخاصية.
    • |rank=valid يظهر البنود المفضلة والتي بوضع "ترتيب عادي" ولكن لا يظهر المهملة.
    • |rank=best (افتراضي) يظهر القيم المفضلة.

فرز النتيجة / sort[تعديل]

  • |sortbytime= الترتيب حسب الوقت يفيد هذا مع المعلمة |enbarten= أعلاه
    • |sortbytime=chronological ترتيب البنود حسب زمن التصفيات المذكورة.
    • |sortbytime=inverted عكس البنذ السابق.

المراجع / 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= يضيف تصفية (P585) إذا كانت موجودة.
  • |bothdates= يضيف تصفيات تاريخ البدايه (P580) وتاريخ النهايه (P582) إذا كانتا موجودتان كلاهما أو إحداهما.
    • |bothdates=line يضع سطر جديد قبل التاريخ، |bothdates=before يضع التاريخ قبل القيمة، |bothdates=after يضع التاريخ بعد القيمة.
  • |qual1= يضيف تصفية محددة.
فلترة النتائج[تعديل]
  • |avoidqualifier= يتجاهل القيم التي تحتوي تصفيات معينة، مثل: |avoidqualifier=P518 يظهر البند الذي لا يحتوي على تصفية (P518).
    • بإستخدام |avoidqualifiervalue= مع |avoidqualifier= فإن ذلك يحدد قيمة التصفية إذا طابقت الوسيط |avoidqualifiervalue= فلن يتم إظهارها، وإذا لم تطابق فسيتم إظهارها، يدعم حالياً العناصر/items فقط.
  • |preferqualifier= تحديد خاصية تصفيات يجب أن تكون بيانات الخاصية متضمنتها.
    • |preferqualifiervalue= تحدد القيمة التي تناسب أعلاه. يدعم حالياً العناصر فقط.
  • |justthisqual= يظهر فقط التصفية، إذا لم تكن التصفية موجودة لن يظهر شيء.

وسائط حسب نوع البيانات / datatype[تعديل]

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

{{#invoke:Wikidata2|formatStatements|entityId=Q76|property=P18|noref=true|rank=best}} ينتج ← President Barack Obama.jpg

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


  • |center= لجعل الصورة في الوسط ضع قيمة هذا الخيار |center=yes.
توصيف يظهر
{{#invoke:Wikidata2|formatStatements|entityId=Q76|property=P18|image=true|noref=true|rank=best|size=100|center=yes}}


إحداثيات جغرافية / coordinate[تعديل]
  • |formatting=latitude يعرض خط العرض فقط.
  • |formatting=longitude يعرض خط الطول فقط.
  • |formatting=precision يعرض الدقة.
  • |formatting=globe يعرض عنصر الكوكب. مثال:
توصيف يظهر
{{#invoke:Wikidata2|formatStatements|entityId=Q805|property=P625|formatting=globe}}

Q2

{{#invoke:Wikidata2|formatStatements|entityId=Q805|property=P625|formatting=longitude}}

48


نص أحادي اللغة / نص بلغة وحيدة / monolingualtext[تعديل]
  • |langpref= في الوحدة، هناك مرشح يعطي أولوية للقيم التي تحتوي على "اللغة = العربية". أضف القيمة المطلوبة لتعطيل هذا الفلتر.
    • القيم المقبولة التانيه هي : justlang و langcode
    • |langpref=justlang لإظهار لغة النص فقط دون النص، مثل الإنجليزية.
توصيف يظهر
{{#invoke:Wikidata2|formatStatements|entityId=Q76|property=P1477|langpref=justlang}}

الإنجليزية


    • |langpref=justlang لإظهار رمز لغة النص فقط دون النص، مثل en.
توصيف يظهر
{{#invoke:Wikidata2|formatStatements|entityId=Q76|property=P1477|langpref=langcode}}

en

توصيف يظهر
{{#invoke:Wikidata2|formatStatements|entityId=Q76|property=P1477|showlang=true}}

(بالانجليزى: Barack Hussein Obama II)


كمية / quantity[تعديل]
  • |nounitlink= يظهر وحدة القياس دون وصلة.

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

توصيف يظهر
{{#invoke:Wikidata2|formatStatements|entityId=Q805|property=P2046|noref=t|firstvalue=y}}

خطأ لوا في وحدة:Math على السطر 635: attempt to call field '?' (a nil value).

  • |formatcharacters=formatnum: تنسيق الأرقام بالفواصل.
توصيف يظهر
{{#invoke:Wikidata2|formatStatements|entityId=Q805|property=P2046|firstvalue=y|noref=t|formatcharacters=formatnum}}

خطأ لوا في وحدة:Math على السطر 635: attempt to call field '?' (a nil value).


  • |nounit= لا يظهر وحدة القياس.
توصيف يظهر
{{#invoke:Wikidata2|formatStatements|entityId=Q805|property=P2046|noref=t|firstvalue=y|nounit=t}}

خطأ لوا في وحدة:Math على السطر 635: attempt to call field '?' (a nil value).


  • مثال لاستخدام |unitshort= ومثال عند عدم استخدامه:
توصيف يظهر
{{#invoke:Wikidata2|formatStatements|entityId=Q219635|property=P2295|unitshort=t}}

خطأ لوا في وحدة:Math على السطر 635: attempt to call field '?' (a nil value).

{{#invoke:Wikidata2|formatStatements|entityId=Q219635|property=P2295}}

خطأ لوا في وحدة:Math على السطر 635: attempt to call field '?' (a nil value).


نص / string[تعديل]
  • |stringpattern= تنسيق النص في قالب أو وصلة أو ماشابه يتم استبدال القيمة بـ$1. مثل |pattern= لكن هنا تستخدم مع نوع البيانات string.
توصيف يظهر
{{#invoke:Wikidata2|formatStatements|entityId=Q1133289|property=P1748|noref=t|stringpattern=[https://ncit.nci.nih.gov/ncitbrowser/ConceptReport.jsp?dictionary=NCI%20Thesaurus&code=$1 $1]}}


نقطة زمنية / time[تعديل]
  • |modifytime= يحدد تنسيق الوقت أو التاريخ:
    • |modifytime=longdate يكتب التاريخ في شكل "24 ابريل 2024"
    • |modifytime=Y يكتب التاريخ في شكل "2024" يظهر فقط السنة.
    • |modifytime= F يكتب التاريخ في شكل "ابريل" يظهر فقط الشهر.
    • |modifytime= j يكتب التاريخ في شكل "24" يظهر فقط اليوم.
  • |modifyqualifiertime= تنسيق التاريخ على النحو الوارد أعلاه، ولكن يؤثر فقط على التصفيات. qualifier
معرف خارجي / external-id[تعديل]
افتراضي:
توصيف يظهر
{{#invoke:Wikidata2|formatStatements|entityId=Q76|property=P2002}}

BarackObama


  • |pattern= طريقة عرض الخاصية مثلاً في وصلات الضبط الاستنادي $1 مثلاً: <nowiki>https://viaf.org/viaf/$1/</nowiki> .
  • |pattern=autourl من خواص البند أعلاه، لنمط مستخدم في الخاصية (P1630) (تنسيق عنوان URL) للخاصية المطلوبة.
توصيف يظهر
{{#invoke:Wikidata2|formatStatements|entityId=Q76|property=P2002|pattern=autourl}}


  • |pattern=autourl2 كما سبق، يقدم وصلة من نوع <nowiki>[https://viaf.org/viaf/$1/ $1] </nowiki>
توصيف يظهر
{{#invoke:Wikidata2|formatStatements|entityId=Q76|property=P2002|pattern=autourl2}}


المسار / url[تعديل]
توصيف يظهر
{{#invoke:Wikidata2|formatStatements|entityId=Q76|property=P2035}}
{{#invoke:Wikidata2|formatStatements|urllabel=لينكد إن|entityId=Q76|property=P2035}}
  • |displayformat= يقبل حالياً قيمة واحدة وهي |displayformat=weblink لاستخدام وحدة:weblink لعرض وصلة الموقع.
{{#invoke:Wikidata2|formatStatements|entityId=Q76|property=P2035|displayformat=weblink}} ينتج ←

خيارات إضافية[تعديل]

  • |NosValue= يستخدم لإظهار نتيجة ما عند عدم وجود قيمة محلية في وسيط |value= وعدم وجود قيمة في ويكي بيانات.

property-(module/function) و claim-(module/function) و value-(module/function)[تعديل]

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

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

{{ fun( claims, options )}}

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

{{ fun( statement, options )}}

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

{{ fun( datavalue, datatype, options )}}

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

pageId[تعديل]

{{#invoke:Wikidata2|pageId}}

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

labelIn[تعديل]

  • |1= اللغة مثل fr.
  • |2= عنصر ويكي بيانات مثل Q76.

مثال: {{#invoke:Wikidata2|labelIn|fa|Q76}} ينتج: باراك اوباما

descriptionIn[تعديل]

  • |1= اللغة مثل fr.
  • |2= عنصر ويكي بيانات مثل Q76.

مثال: {{#invoke:Wikidata2|descriptionIn|en|Q76}} ينتج:

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

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

مثال: {{#invoke:Wikidata2|getSiteLink|Q76}} ينتج: باراك اوباما

مثال: {{#invoke:Wikidata2|getSiteLink|Q76|enwiki}} أو: {{#invoke:Wikidata2|getSiteLink|id=Q76|site=enwiki}}

ينتج: Barack Obama

أو: قالب:توصيف2

Dump[تعديل]

مثال: {{#invoke:Wikidata2|Dump|claims|P19}}

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

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

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

مثال:

توصيف يظهر
{{#invoke:Wikidata2|isSubclass|parent=Q5|maxDepth=1|id=Q76}}

true

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


EntityIdForTitle[تعديل]

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

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

آخر التحديثات[تعديل]