وحدة:Wikidata2/شرح

من وي عرب
مراجعة ٢٣:٢٩، ٢٠ نوفمبر ٢٠٢١ بواسطة Anmar (نقاش | مساهمات) (مراجعة واحدة)
(فرق) → مراجعة أقدم | المراجعة الحالية (فرق) | مراجعة أحدث ← (فرق)
اذهب إلى التنقل اذهب إلى البحث

هذه صفحة توثيق لوحدة: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 عكس البند السابق.
    • |sortingproperty= تحديد الخواص المدعومة، الافتراضي هو:'P585','P571','P580','P569','P582','P570' بالترتيب، الخواص المعتمدة حالياً هي خواص الوقت. (P585) ، (P571) ، (P580) ، (P569) ، (P582) ، (P570).
    • |sortingproperty=sortbyarbitrary فرز القيم بواسطة تاريخ العناصر المرتبطة مثل تاريخ ولادة أبناء شخص "الأطفال". القيم المسموح بها هي:
      • |sortingproperty=chronological
      • |sortingproperty=inverted . وتعطى مع الخاصية المراد تفتيشها ' sortingproperty اعلاه'.

    المراجع / 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= يضيف تصفية محددة.
    • |qual1=P1545 يضيف تصفية (P1545) الى بنود الخاصية، مثال:منصب باراك أوباما + ترتيبه:
  • فلترة النتائج
    • |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).
    prefervalue
    • |prefervalue= يستخدم هذا الوسيط بشكل معاكس للوسيط |avoidvalue= حيث نقوم بتحديد القيمة التي نريد ظهورها |prefervalue=Q19481 فتظهر النتيجة للعنصر (Q19481) فقط، ولكن الفائدة من إستخدام هذا الوسيط هي التأكد من وجود العنصر في هذه الخاصية أو للحصول على التصفيات، مثال يظهر عناصر (P1346) مع تصفية (P1923) بين قوسين.
    توصيف يظهر
    {{#invoke:Wikidata2|formatStatements|entityId=Q39052816|property=P1923|qual1=P1355}} 


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

    توصيف يظهر
    {{#invoke:Wikidata2|formatStatements|entityId=Q39052816|property=P1923|justthisqual=P1355}} 

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

    توصيف يظهر
    {{#invoke:Wikidata2|formatStatements|entityId=Q39052816|property=P1923|prefervalue=Q50602|qual1=P1355}} 

    {{#invoke:Wikidata2|formatStatements|entityId=Q39052816|property=P1923|prefervalue=Q50602|justthisqual=P1355}} 


    ملف وسائط من كومنز / commonsMedia
    • تظهر الصور افتراضياً كالتالي:

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

    • |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}} 

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


    نص أحادي اللغة / نص بلغة وحيدة / 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}} 
    توصيف يظهر
    {{#invoke:Wikidata2|formatStatements|entityId=Q76|property=P1477|showlang=true}} 


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


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

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

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


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


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

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


    نص / 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 يكتب التاريخ في شكل "٣١ أكتوبر ٢٠٢٤"
      • |modifytime=Y يكتب التاريخ في شكل "٢٠٢٤" يظهر فقط السنة.
      • |modifytime= F يكتب التاريخ في شكل "أكتوبر" يظهر فقط الشهر.
      • |modifytime= j يكتب التاريخ في شكل "٣١" يظهر فقط اليوم.
    • |modifyqualifiertime= تنسيق التاريخ على النحو الوارد أعلاه، ولكن يؤثر فقط على التصفيات. qualifier
    معرف خارجي / external-id
    افتراضي:
    توصيف يظهر
    {{#invoke:Wikidata2|formatStatements|entityId=Q76|property=P2002}} 


    • |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
    • |urllabel= وضع تسمية لتظهر بدلاً من الوصلة، كما في معرف خارجي ولكن في خواص الروابط.
      • مثال عند استخدام (P856) ل (Q76) مع/بدون الوسيط |urllabel=الموقع الرسمي:
    توصيف يظهر
    {{#invoke:Wikidata2|formatStatements|entityId=Q76|property=P856}} 

    {{#invoke:Wikidata2|formatStatements|urllabel=الموقع الرسمي|entityId=Q76|property=P856}} 
    • |displayformat= يقبل حالياً قيمة واحدة وهي |displayformat=weblink لاستخدام وحدة:weblink لعرض وصلة الموقع.
    {{#invoke:Wikidata2|formatStatements|entityId=Q76|property=P856|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}}

    ينتج:

    أو:

    توصيف يظهر
    <syntaxhighlight lang="shell">{{#invoke:Wikidata2 |getSiteLink |page=اليمن |site=enwiki }} </syntaxhighlight>

    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=}}

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

    مثال:

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

    {{#invoke:Wikidata2|isSubclass|parent=Q45|maxDepth=5|id=Q76}} 
    خطأ لوا: عدد كبير جدا من ادعاءات "mw.wikibase.getReferencedEntityId"، فقط ما يصل إلى ٣ مسموح به..


    EntityIdForTitle

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

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

    آخر التحديثات

    • 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 لإظهار تنسيق الأرقام بالفواصل مثل ١٠٬٠٠٠٬٠٠٠.
    • 25 يناير 2018:
      • اضافة الخيار |countsitelinks=t لإظهار عدد وصلات اللغات.
    • 9 ديسمبر 2017:
      • إضافة الخيار |page= يمكن أن يستخدم بديلاً عن |entityId= بوضع اسم الصفحة خاص:فرق/25985344.