وحدة: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= الفاصلة الأخيرة قبل اخر بند، افتراضي ، و .
القيم الافتراضية
توصيف يظهر
{{#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=*}}  

تحديد عدد القيم[عدل]

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


رتبة القيم / 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[عدل]

فلترة النتائج[عدل]
  • |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 فتظهر النتائج دون ظهور أستانا 2016 (Q21769847).
prefervalue[عدل]
  • |prefervalue= يستخدم هذا الوسيط بشكل معاكس للوسيط |avoidvalue= حيث نقوم بتحديد القيمة التي نريد ظهورها |prefervalue=Q19481 فتظهر النتيجة للعنصر ليستر سيتي (Q19481) فقط، ولكن الفائدة من إستخدام هذا الوسيط هي التأكد من وجود العنصر في هذه الخاصية أو للحصول على التصفيات، مثال يظهر عناصر الفائز (P1346) مع تصفية الفرق المشاركة (P1923) بين قوسين.
توصيف يظهر
{{#invoke:Wikidata2|formatStatements|entityId=Q39052816|property=P1923|qual1=P1355}} 
نادي أرسنال (21 )، ‏نادي بورنموث (13 )، ‏برايتون أند هوف ألبيون (9 )، ‏نادي بيرنلي (11 )، ‏كارديف سيتي (10 )، ‏تشيلسي (21 )، ‏كريستال بالاس (14 )، ‏نادي إيفرتون (15 )، ‏ليستر سيتي (15 )، ‏نادي ليفربول (30 )، ‏مانشستر سيتي (32 )، ‏مانشستر يونايتد (19 )، ‏نيوكاسل يونايتد (12 )، ‏توتنهام هوتسبير (23 )، ‏نادي واتفورد (14 )، ‏وست هام يونايتد (15 )، ‏وولفرهامبتون واندررز (16 )، ‏نادي ساوثهامبتون (9 )، ‏نادي فولهام (7 ) و هدرسفيلد تاون (3 )


إذا كنا قد حصلنا عبر خاصية الفائز (P1346) عن الفريق الفائز في الدوري الإنجليزي الممتاز 2018–19 (Q39052816). وأردنا الحصول على عدد مرات الفوز للفريق الفائز، من الجدول السابق ويتم ذلك بإستخدام الوسيط |justthisqual= ما ينتج:

توصيف يظهر
{{#invoke:Wikidata2|formatStatements|entityId=Q39052816|property=P1923|justthisqual=P1355}} 
21 ، ‏13 ، ‏9 ، ‏11 ، ‏10 ، ‏21 ، ‏14 ، ‏15 ، ‏15 ، ‏30 ، ‏32 ، ‏19 ، ‏12 ، ‏23 ، ‏14 ، ‏15 ، ‏16 ، ‏9 ، ‏7 و 3

ولكننا نريد ظهور التصفية للفريق الفائز فقط وهو مانشستر سيتي (Q50602):

توصيف يظهر
{{#invoke:Wikidata2|formatStatements|entityId=Q39052816|property=P1923|prefervalue=Q50602|qual1=P1355}} 
مانشستر سيتي (32 )
{{#invoke:Wikidata2|formatStatements|entityId=Q39052816|property=P1923|prefervalue=Q50602|justthisqual=P1355}} 
32


ملف وسائط من كومنز / 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}} 
President Barack Obama.jpg


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


إحداثيات جغرافية / 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)


توصيف يظهر
{{#invoke:Wikidata2|formatStatements|entityId=Q76|property=P1477|textformat=text}} 
Barack Hussein Obama II


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

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

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


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


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


نص / 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]}} 
C75016 و C75016


نقطة زمنية / time[عدل]
  • |modifytime= يحدد تنسيق الوقت أو التاريخ:
    • |modifytime=longdate يكتب التاريخ في شكل "20 فبراير 2020"
    • |modifytime=Y يكتب التاريخ في شكل "2020" يظهر فقط السنة.
    • |modifytime= F يكتب التاريخ في شكل "فبراير" يظهر فقط الشهر.
    • |modifytime= j يكتب التاريخ في شكل "20" يظهر فقط اليوم.
  • |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}} 
https://twitter.com/BarackObama


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


المسار / 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}} ينتج: 44th president of the United States

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

أو:

توصيف يظهر
{{#invoke:Wikidata2
|getSiteLink
|page=اليمن
|site=enwiki
}}
Yemen

Dump[عدل]

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

مثال2: {{#invoke:Wikidata2|Dump|id=Q76|claims|P19}}
مثال موسع: {{#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

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

  • 4 أبريل 2019:
    • إضافة الوسيط |unitshort= لإستخدام اختصار وحدات القياس أو العملات بدلاً عن عنوان مقالتها.
  • 4 أبريل 2019:
    • إضافة الوسيط |avoidqualifiervalue= عكس الوسيط |preferqualifiervalue= .
    • إخفاء ظهور تصانيف التتبع في التصفيات عند استخدام الوسيط |raw=.
  • 2 أبريل 2019:
    • إضافة الوسيط |stringpattern= تنسيق النص.
  • 12 مارس 2019:
    • إضافة إمكانية وضع حد أقصى لعدد المراجع عبر خيار |numberofreferences=.
  • 3 مارس 2019:
    • إمكانية استخدام |numval= لعرض عدد محدد من القيم في الخاصية.
  • 11 فبراير 2019:
  • 8 فبراير 2019:
    • استخدام وحدة:weblink مع نوع بيانات url / المسار عبر وضع |displayformat=weblink.
  • 4 فبراير 2019:
    • إمكانية استخدام |firstvalue=1 لإظهار القيمة رقم 1 ويمكن الاستخدام حتى رقم 9.
  • 1 فبراير 2019:
  • 20 يناير 2019 :
  • إضافة الخيار returnnumberofvalues لمعرفة عدد قيم النتائج، (يستخدم عبر وحدات لوا)
  • 31 ديسمبر 2018:
    • إضافة الوظيفة getLabel.
  • 18 ديسمبر 2018 :
    • إمكانية حجب قيم من الظهور في خواص معينة مثل حجب العنصر نبي (Q42857) من الظهور عند استخدام خاصية المهنة (P106).
  • 2 مارس 2018 :
  • 5 فبراير 2018:
    • اضافة الخيار |formatcharacters=formatnum لإظهار تنسيق الأرقام بالفواصل مثل 10٬000٬000.
  • 25 يناير 2018:
    • اضافة الخيار |countsitelinks=t لإظهار عدد وصلات اللغات.
  • 9 ديسمبر 2017:
    • إضافة الخيار |page= يمكن أن يستخدم بديلاً عن |entityId= بوضع اسم الصفحة خاص:فرق/25985344.