وحدة:Wikidata2/شرح

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

الاستخدامات

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

الوحدات الفرعية

• وحدة:Wikidata2/Globes
• وحدة:Wikidata2/P106
• وحدة:Wikidata2/P1082
• وحدة:Wikidata2/P172
• وحدة:Wikidata2/P3828
• وحدة:Wikidata2/P39
• وحدة:Wikidata2/P54
• وحدة:Wikidata2/P569-P570
• وحدة:Wikidata2/link
• وحدة:Wikidata2/monolingualtext
• وحدة:Wikidata2/otheruse
• وحدة:Wikidata2/tax
• وحدة:Wikidata2/template
• وحدة:Wikidata2/time
• وحدة:Wikidata2/Flags

الاستعمال

مثال

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

الوسائط

formatStatements

•  انظر أيضا: Help:Statements في ويكي بيانات

• |property= مطلوب الخاصية المطلوبة.

• |entityId= أو |id= معرف عنصر ويكي بيانات.
• |page= يمكن إستخدامه بدلاً من |entityId=Q805 كالتالي: |page=اليمن .

• |enbarten= أو |firstvalue= يعرض أول قيمة فقط في الخاصية.
  • |firstvalue=2 يعرض القيمة الثانية في الخاصية إن كانت موجودة، يمكن استخدام هذا الخيار حتى رقم 9.
• |numval= يعرض عدد محدد من القيم في الخاصية.
  • |numval=4 يعرض القيم الأربع الأولى في الخاصية إن كانت موجودة.
• |prefix= بادئة
• |suffix= لاحقة
• |formatting= يحدد تنسيق القيم يستخدم مع ⧼datatypes-type-globe-coordinate⧽، و⧼datatypes-type-wikibase-item⧽، و⧼datatypes-type-wikibase-property⧽.

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

•  انظر أيضا: Help:Ranking في ويكي بيانات

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

•  انظر أيضا: Help:Sources في ويكي بيانات

• |noref= أدخل قيمة في هذه المعلمة إذا كنت لا تريد جلب المصادر من ويكي بيانات.
• |justref= أدخل قيمة في هذه المعلمة إذا كنت تريد جلب المصادر فقط دون ظهور القيمة!.
• |onlyvaluewithref= لإظهار البيانات التي لها مراجع فقط.
• |numberofreferences= لوضع حد أقصى للمراجع لكل قيمة، مثلاً عند تحديد |numberofreferences=1 يظهر مرجع واحد فقط في كل قيمة إن كان متوفراً.

صياغة النص

• |formatcharacters= تحديد صيغة اخراج القيمة، القيم المسموح بها هي: lc/uc/lcfirst/ucfirst/formatnum
  • |formatcharacters=lc: تحويل جميع أحرف النص الإنجليزي إلى حروف صغيرة.
  • |formatcharacters=lcfirst: تحويل الحرف الأول من النص الإنجليزي إلى حرف صغير.
  • |formatcharacters=uc : تحويل جميع أحرف النص الإنجليزي إلى حروف كبيرة.
  • |formatcharacters=ucfirst: تحويل الحرف الأول من النص الإنجليزي إلى حرف كبير.
  • |formatcharacters=formatnum: مشروحة في #كمية.

تصفيات / Qualifiers

•  انظر أيضا: Help:Qualifiers في ويكي بيانات

• |withdate= يضيف تصفية (P585) إذا كانت موجودة.
• |bothdates= يضيف تصفيات (P580) و (P582) إذا كانتا موجودتان كلاهما أو إحداهما.
  • |bothdates=line يضع سطر جديد قبل التاريخ، |bothdates=before يضع التاريخ قبل القيمة، |bothdates=after يضع التاريخ بعد القيمة.
• |qual1= يضيف تصفية محددة.
  • |qual1=P1545 يضيف تصفية (P1545) الى بنود الخاصية، مثال:منصب باراك أوباما + ترتيبه:
    • {{#invoke:Wikidata2|formatStatements|entityId=Q76|property=P39|qual1=P1545|noref=true|rank=best}} ينتج :← رئيس الولايات المتحدة (44)

فلترة النتائج

• |avoidqualifier= يتجاهل القيم التي تحتوي تصفيات معينة، مثل: |avoidqualifier=P518 يظهر البند الذي لا يحتوي على تصفية (P518).
  • بإستخدام |avoidqualifiervalue= مع |avoidqualifier= فإن ذلك يحدد قيمة التصفية إذا طابقت الوسيط |avoidqualifiervalue= فلن يتم إظهارها، وإذا لم تطابق فسيتم إظهارها، يدعم حالياً العناصر/items فقط.
• |preferqualifier= تحديد خاصية تصفيات يجب أن تكون بيانات الخاصية متضمنتها.
  • |preferqualifiervalue= تحدد القيمة التي تناسب أعلاه. يدعم حالياً العناصر فقط.
• |justthisqual= يظهر فقط التصفية، إذا لم تكن التصفية موجودة لن يظهر شيء.

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

⧼datatypes-type-wikibase-item⧽ / item

•  انظر أيضا: Help:Items في ويكي بيانات

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

⧼datatypes-type-commonsMedia⧽ / 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}}

⧼datatypes-type-globe-coordinate⧽ / 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}}

نص أحادي اللغة / ⧼datatypes-type-monolingualtext⧽ / monolingualtext

•  انظر أيضا: Help:Monolingual text languages في ويكي بيانات

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

• |showlang= استخدم أي قيمة لإظهار النص حسب تنسيق قالب:رمز لغة واسمها.

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

• |textformat=text اظهار النص فقط دون استخدام قوالب {{رمز لغة واسمها}} أو {{رمز لغة}}

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

⧼datatypes-type-quantity⧽ / 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}}

⧼datatypes-type-string⧽ / 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]}}

⧼datatypes-type-time⧽ / time

• |modifytime= يحدد تنسيق الوقت أو التاريخ:
  • |modifytime=longdate يكتب التاريخ في شكل "22 نوفمبر 2024"
  • |modifytime=Y يكتب التاريخ في شكل "2024" يظهر فقط السنة.
  • |modifytime= F يكتب التاريخ في شكل "نوفمبر" يظهر فقط الشهر.
  • |modifytime= j يكتب التاريخ في شكل "22" يظهر فقط اليوم.
• |modifyqualifiertime= تنسيق التاريخ على النحو الوارد أعلاه، ولكن يؤثر فقط على التصفيات. qualifier

⧼datatypes-type-external-id⧽ / 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}}

⧼datatypes-type-url⧽ / url

• |urllabel= وضع تسمية لتظهر بدلاً من الوصلة، كما في ⧼datatypes-type-external-id⧽ ولكن في خواص الروابط.
  • مثال عند استخدام (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 وتنسيقها والتحكم بها.
• أمثلة:
  • الوحدة وحدة:Wikidata2/P39 الخاصة بخاصية المنصب (P39).

value

‏

fun( datavalue, datatype, options )

‏

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

• أمثلة:
  • الوحدة وحدة:Wikidata2/P106 الخاصة بخاصية المهنة.

pageId

{{#invoke:Wikidata2|pageId}}

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

labelIn

•  انظر أيضا: Help:Label في ويكي بيانات

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

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

descriptionIn

•  انظر أيضا: Help:Description في ويكي بيانات

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

ينتج:

أو:

توصيف	يظهرقالب:توصيف2/صف

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

EntityIdForTitle

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

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

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