عرض مصدر قالب:قيمة ويكي بيانات/شرح

{{صفحة توثيق فرعية}}
{{يستخدم ويكي بيانات|قسم=ويكي بيانات}}
{{قوالب ويكي بيانات}}
{{استخدام واسع|{{قيمة ويكي بيانات/شرح/عداد}}}}
قالب:قيمة ويكي بيانات، يمكن استخدامه لجلب قيمة <code>value</code> أي محتوى من [[ويكي بيانات]].
{{ص.م/سطر مختلط اختياري ويكي بيانات2/شرح}}

== كافة معطيات القالب ==
<!-- هذا الكود تم توليده تلقائياً عبر [[قالب:Parameters]]
-->
<pre>{{قيمة ويكي بيانات
| ملعب = <!-- اذا أردنا استخدام [[وحدة:wikidata/ملعب]] نضع (|ملعب=ملعب)-->
| 1 = <!-- مثلاً {{{الزوج|}}}-->
| قيمة موجودة =<!-- إذا كانت 1 موجودة أظهر هذه القيمة مثلاً / <code>{{{الزوج|}}} في {{{مكان الزواج|}}}</code> -->
| خاصية = <!-- مثلاً <code>P17</code>-->
| معرف ويكي بيانات =<!-- <code>Q76</code> صفحة باراك أوباما.-->
| مقالة =<!-- يمكن استخدامه بدلاً من |معرف ويكي بيانات= مثل: | مقالة =اليمن -->
| langpref =<!-- يستخدم عند خواص نصوص ذو لغات مثلاً الاسم باللغة الأصلية.-->
| showlang =<!-- يظهر اللغة بجانب التسمية في البند أعلاه.-->
| addTrackingCat = 
| enlabelcate = 

| رمز = 
| icon2 = 
| بادئة = 
| لاحقة = 
| لاحقة2 = 

| خاصية قيمة = 
| سابقة خاصية قيمة = 
| لاحقة خاصية قيمة = 
| property1after = 
| property1formatting = 
| صورة = 
| حجم صورة = 
| formatting = 
| illwd2 = 
| نمط = 
| وصلة = 
| تسمية وصلة = 
| بديل = 
| مراجع = 
| تصفية فقط = 
| modifytime = 
| rank = 
| بداية ونهاية = 
| نقطة = 
| واحد فقط = 
| modifyqualifiertime = 

| تصفية = 
| سابقة تصفية = 
| تصفية1 = 
| سابقة تصفية1 = 
| تصفية2 = 
| سابقة تصفية2 = 
| تصفية3 = 
| سابقة تصفية3 = 
| تصفية4 = 
| سابقة تصفية4 = 
| تصفية5 = 
| سابقة تصفية5 = 
| ترتيب = 
| خيار = 
| قيمة خيار = 
| value-module = 
| value-function = 
| propertyimage = 
| property2 = 
| بادئة تصفيات = 
| لاحقة تصفيات = 
| تجاهل تصفية = 
| avoidqualifier = 
| قائمة = 
| قائمة شريطية = 
| separator = 
}}</pre>

== إضافة ==
يمنع القالب ظهور بيانات من ويكي بيانات للخواص {{خاصية|172}} و{{خاصية|P140}} و{{خاصية|P91}} و{{خاصية|P1853}} إلا في حالة وجود مصدر لها.

=== أمثلة ===
{{أحمر|{{#تبديل:{{SUBPAGENAME}}|ملعب=* القالب المستخدم في الأمثلة هو : [[قالب:قيمة ويكي بيانات/ملعب]]|#default=}} }}
=== المعطيات المستخدمة في حالة وجود قيمة محلية ===
{{توصيف
|عنوان={{param|1}} و :{{وسيط قالب|قيمة موجودة}}:
|<nowiki>{{قيمة ويكي بيانات
|{{{تعداد السكان|؟}}}
|قيمة موجودة= {{{تعداد السكان|؟}}} ({{{سنة التعداد}}})
|خاصية =
}}
</nowiki>
|{{قيمة ويكي بيانات{{#تبديل:{{SUBPAGENAME}}|ملعب=/ملعب|#default=}}
|{{{تعداد السكان|؟}}}
|قيمة موجودة= {{{تعداد السكان|؟}}} ({{{سنة التعداد}}})
|خاصية =
}}
}}

=== المعطيات المستخدمة إذا لم يكن هناك قيمة محلية ===

*<code>|{{{1}}}=لا</code> يؤدي وضع القيمة إلى <code>لا</code> في أي قالب يستخدم {{قا|قيمة ويكي بيانات}} إلى منع ظهور القيمة المقابلة لها من ويكي بيانات.
*{{وسيط قالب|خاصية}}
مثلاً في صفحة مدينة [[ريو دي جانيرو]]:
{{توصيف
|عنوان=-{{وسيط قالب|خاصية}}:
|<nowiki>{{قيمة ويكي بيانات
|{{{تعداد السكان|}}}
|خاصية =P1082
}}
</nowiki>
|{{قيمة ويكي بيانات{{#تبديل:{{SUBPAGENAME}}|ملعب=/ملعب|#default=}}
|معرف ويكي بيانات=Q2471
|{{{تعداد السكان|}}}
|خاصية =P1082
|مراجع=لا
}}
}}

{{توصيف
|عنوان={{وسيط قالب|واحد فقط}}: تستخدم لعرض أول قيمة فقط.
|<nowiki>{{قيمة ويكي بيانات
|{{{تعداد السكان|}}}
|خاصية =P1082
|واحد فقط=نعم
}}
</nowiki>
|{{قيمة ويكي بيانات{{#تبديل:{{SUBPAGENAME}}|ملعب=/ملعب|#default=}}
|معرف ويكي بيانات=Q2471
|{{{تعداد السكان|}}}
|خاصية =P1082
|واحد فقط=نعم
|مراجع=لا
}}
}}

{{توصيف
|عنوان={{وسيط قالب|rank}} إما {{وسيط قالب|rank|all}} أو {{وسيط قالب|rank|best}} 
|<nowiki>{{قيمة ويكي بيانات
|{{{عاصمة لـ|}}}
|خاصية =P1376
|rank=best
}}
</nowiki>
|{{قيمة ويكي بيانات{{#تبديل:{{SUBPAGENAME}}|ملعب=/ملعب|#default=}}
|معرف ويكي بيانات=Q2471
|{{{عاصمة لـ|}}}
|خاصية =P1376
|rank=best
|مراجع=لا
}}
|<nowiki>{{قيمة ويكي بيانات
|{{{عاصمة لـ|}}}
|خاصية =P1376
|rank=all
}}
</nowiki>
|{{قيمة ويكي بيانات{{#تبديل:{{SUBPAGENAME}}|ملعب=/ملعب|#default=}}
|معرف ويكي بيانات=Q2471
|{{{عاصمة لـ|}}}
|خاصية =P1376
|rank=all
|مراجع=لا
}}

}}

==== وسائط التنسيق ====
{{توصيف
|عنوان={{وسيط قالب|قائمة}} :
|<nowiki>{{قيمة ويكي بيانات
|{{{تعداد السكان|}}}
|خاصية =P1082
|قائمة=نعم
}}
</nowiki>
|{{قيمة ويكي بيانات{{#تبديل:{{SUBPAGENAME}}|ملعب=/ملعب|#default=}}
|معرف ويكي بيانات=Q2471
|{{{تعداد السكان|}}}
|خاصية =P1082
|مراجع=لا
|قائمة=نعم
}}
}}

{{توصيف
|عنوان={{وسيط قالب|سابقة}} و{{وسيط قالب|لاحقة}}:
|<nowiki>{{قيمة ويكي بيانات
|{{{تعداد السكان|}}}
|خاصية =P1082
|سابقة={{{سابقة}}}
|لاحقة={{{لاحقة}}}
|قائمة=نعم
}}
</nowiki>
|{{قيمة ويكي بيانات{{#تبديل:{{SUBPAGENAME}}|ملعب=/ملعب|#default=}}
|{{{تعداد السكان|}}}
|خاصية =P1082
|معرف ويكي بيانات=Q2471
|سابقة={{{سابقة}}}
|لاحقة={{{لاحقة}}}
|قائمة=نعم
|مراجع=لا
}}
}}

==== وسائط التصفيات ====
:مثال لمدينة [[صنعاء]]:
{{توصيف
|عنوان={{وسيط قالب|نقطة}} (تعني خاصية {{خاصية|P585}})، 
{{وسيط قالب|بداية ونهاية}} (تعني خاصيتي {{خاصية|P580}} و {{خاصية|P582}})
|<nowiki>{{قيمة ويكي بيانات
|معرف ويكي بيانات=Q2471
|{{{تعداد السكان|}}}
|خاصية =P1082
|قائمة=نعم
|نقطة=نعم
}}
</nowiki>
|{{قيمة ويكي بيانات{{#تبديل:{{SUBPAGENAME}}|ملعب=/ملعب|#default=}}
|معرف ويكي بيانات=Q2471
|{{{تعداد السكان|}}}
|خاصية =P1082
|مراجع=لا
|قائمة=نعم
|نقطة=نعم
}}
|<nowiki>{{قيمة ويكي بيانات
|معرف ويكي بيانات=Q2471
|{{{عاصمة لـ|}}}
|خاصية =P1376
|قائمة=نعم
|بداية ونهاية=نعم
}}
</nowiki>
|{{قيمة ويكي بيانات{{#تبديل:{{SUBPAGENAME}}|ملعب=/ملعب|#default=}}
|معرف ويكي بيانات=Q2471
|{{{عاصمة لـ|}}}
|خاصية =P1376
|مراجع=لا
|قائمة=نعم
|بداية ونهاية=نعم
}}
}}
----
: يمكن استخدام {{وسيط قالب|مقالة|صنعاء}} بدلاً من {{وسيط قالب|معرف ويكي بيانات|Q2471}}
{{توصيف
|عنوان={{وسيط قالب|بادئة تصفيات}} و{{وسيط قالب|لاحقة تصفيات}}:
|<nowiki>{{قيمة ويكي بيانات
|مقالة=صنعاء
|{{{تعداد السكان|}}}
|خاصية =P1082
|قائمة=نعم
|نقطة=نعم
|بادئة تصفيات=سنة:
|لاحقة تصفيات= م.
}}
</nowiki>
|{{قيمة ويكي بيانات{{#تبديل:{{SUBPAGENAME}}|ملعب=/ملعب|#default=}}
|مقالة=صنعاء
|{{{تعداد السكان|}}}
|خاصية =P1082
|مراجع=لا
|قائمة=نعم
|نقطة=نعم
|بادئة تصفيات=سنة:
|لاحقة تصفيات= م.
}}
|<nowiki>{{قيمة ويكي بيانات
|مقالة=صنعاء
|{{{عاصمة لـ|}}}
|خاصية =P1376
|قائمة=نعم
|بداية ونهاية=نعم
|بادئة تصفيات=، خلال الفترة (
|لاحقة تصفيات= ).
}}
</nowiki>
|{{قيمة ويكي بيانات{{#تبديل:{{SUBPAGENAME}}|ملعب=/ملعب|#default=}}
|مقالة=صنعاء
|{{{عاصمة لـ|}}}
|خاصية =P1376
|مراجع=لا
|قائمة=نعم
|بداية ونهاية=نعم
|بادئة تصفيات=، خلال الفترة (
|لاحقة تصفيات= ).
}}
}}

----

{{توصيف
|عنوان={{وسيط قالب|تصفية}} و{{وسيط قالب|سابقة تصفية}} :
|<nowiki>{{قيمة ويكي بيانات
|معرف ويكي بيانات=Q2471
|{{{تعداد السكان|}}}
|خاصية =P1082
|قائمة=نعم
|نقطة=نعم
|تصفية=P459
|سابقة تصفية=طريقة الاستدلال:
}}
</nowiki>
|{{قيمة ويكي بيانات{{#تبديل:{{SUBPAGENAME}}|ملعب=/ملعب|#default=}}
|معرف ويكي بيانات=Q2471
|{{{تعداد السكان|}}}
|خاصية =P1082
|قائمة=نعم
|نقطة=نعم
|تصفية=P459
|سابقة تصفية=طريقة الاستدلال:
|مراجع=لا
}}
}}

==== وسائط أخرى ====
في هذا المثال سنحاول التعمق أكثر، فعندما نعرض مثلاً {{خاصية|P1376}} لمدينة [[صنعاء]]، والتي ستكون [[اليمن]] <small>(1990–)</small>، [[الجمهورية العربية اليمنية|والجمهورية العربية اليمنية]] <small>(1962–1990)</small>، [[المملكة المتوكلية اليمنية|والمملكة المتوكلية اليمنية]] <small>(–1990)</small> ولكن نريد مثلاً جلب أعلام الدول المذكورة، هنا نستخدم {{وسيط قالب|خاصية قيمة}} بقيمة {{خاصية|P41}} كالتالي:

{{#invoke:DemoTemplate2|قيمة ويكي بيانات{{#تبديل:{{SUBPAGENAME}}|ملعب=/ملعب|#default=}}
|_dir_=rtl|_demonewline_=1
|demotitle={{وسيط قالب|خاصية قيمة}}:
|معرف ويكي بيانات=Q2471
|خاصية =P1376
|خاصية قيمة=P41
|قائمة=نعم
|مراجع=لا
}}
;ماذا لو نريد ظهور القيمة الجديدة كصورة دون الحاجة لمزيد من التعقيد؟!:

{{#invoke:DemoTemplate2|قيمة ويكي بيانات{{#تبديل:{{SUBPAGENAME}}|ملعب=/ملعب|#default=}}
|_dir_=rtl|_demonewline_=1
|demotitle={{وسيط قالب|خاصية قيمة}} و{{وسيط قالب|صورة}} و{{وسيط قالب|حجم صورة}} :
|معرف ويكي بيانات=Q2471
|خاصية =P1376
|خاصية قيمة=P41
|صورة=نعم
|حجم صورة=20
|قائمة=نعم
|مراجع=لا
}}

{{#invoke:DemoTemplate2|قيمة ويكي بيانات{{#تبديل:{{SUBPAGENAME}}|ملعب=/ملعب|#default=}}
|_dir_=rtl
|_demonewline_=
|demotitle=نفس المثال لكن مع تحديد الأفضلية:
|معرف ويكي بيانات=Q2471
|خاصية =P1376
|خاصية قيمة=P41
|صورة=نعم
|حجم صورة=20
|قائمة=نعم
|rank=best
|مراجع=لا
}}

==== تنسيق القيمة ====
الوسيطان {{وسيط قالب|خيار}} و{{وسيط قالب|قيمة خيار}} يمكن أن يعملان مع أي من خيارات [[وحدة:wikidata2]] غير الموجودة في قالب قيمة ويكي بيانات:
:فمثلاً عند وضع {{وسيط قالب|خيار|property1pattern}} و{{وسيط قالب|قيمة خيار|الرمز: $1}} فإننا نكتب وسيطاً جديداً هو {{وسيط قالب|property1pattern|الرمز: $1}}.
مثال: في صفحة {{وصلة ويكي بيانات|Q16611}} عند جلب خاصية {{خاصية|P462}} وأيضاً جلب خاصية {{خاصية|P465}} من القيم الناتجة:
{{#invoke:DemoTemplate2|قيمة ويكي بيانات{{#تبديل:{{SUBPAGENAME}}|ملعب=/ملعب|#default=}}
|_dir_=rtl|_demonewline_=
|demotitle={{وسيط قالب|خيار}} و{{وسيط قالب|قيمة خيار}} 
|خاصية=P462
|معرف ويكي بيانات=Q16611
|خاصية قيمة=P465
|قائمة=نعم
|خيار=property1pattern
|قيمة خيار=الرمز: $1
|مراجع=لا
}}

{{#invoke:DemoTemplate2|قيمة ويكي بيانات{{#تبديل:{{SUBPAGENAME}}|ملعب=/ملعب|#default=}}
|_dir_=rtl|_demonewline_=1
|demotitle=
|خاصية=P462
|معرف ويكي بيانات=Q16611
|خاصية قيمة=P465
|قائمة=نعم
|خيار=property1pattern
|قيمة خيار={{مربع لون|#$1|&nbsp;&nbsp;}}
|مراجع=لا
}}

{{#invoke:DemoTemplate2|قيمة ويكي بيانات{{#تبديل:{{SUBPAGENAME}}|ملعب=/ملعب|#default=}}
|_dir_=rtl|_demonewline_=1
|demotitle=
|خاصية=P462
|معرف ويكي بيانات=Q16611
|خاصية قيمة=p18
|قائمة=نعم
|مراجع=لا
}}

=== المعرفات external-id ===
;وصلة محلية كاملة، ومن ويكي بيانات فقط كود أو معرف external-id :
{{توصيف
|قيمة موجودة محلياً: <nowiki>{{قيمة ويكي بيانات
|{{{VIAF|0123456789}}}
|خاصية = P214
}}</nowiki>
| {{قيمة ويكي بيانات{{#تبديل:{{SUBPAGENAME}}|ملعب=/ملعب|#default=}}
|{{{VIAF|0123456789}}}
|معرف ويكي بيانات=Q2471
|خاصية = P214
|مراجع=لا
}}
|قيمة موجودة محلياً مع تنسيق مسبق:
<nowiki>{{قيمة ويكي بيانات
|{{{VIAF|0123456789}}}
|قيمة موجودة=https://www.example.com/{{{VIAF|}}}
|خاصية = P214
}}</nowiki>
|{{قيمة ويكي بيانات{{#تبديل:{{SUBPAGENAME}}|ملعب=/ملعب|#default=}}
|{{{VIAF|0123456789}}}
|قيمة موجودة=https://www.example.com/{{{VIAF|0123456789}}}
|معرف ويكي بيانات=Q2471
|خاصية = P214
|مراجع=لا
}}
|القيمة غير موجودة محلياً:<nowiki>{{قيمة ويكي بيانات
|{{{VIAF|}}}
|قيمة موجودة=https://www.example.com/{{{VIAF|}}}
|خاصية = P214
}}</nowiki>
|{{قيمة ويكي بيانات{{#تبديل:{{SUBPAGENAME}}|ملعب=/ملعب|#default=}}
|{{{VIAF|}}}
|قيمة موجودة=https://www.example.com/{{{VIAF|}}}
|معرف ويكي بيانات=Q2471
|خاصية = P214
|مراجع=لا
}}
}}
{{توصيف
|عنوان= قيمة وصلة من ويكي بيانات، ونريد وضع لها رابط، باستخدام {{وسيط قالب|وصلة}}، و{{وسيط قالب|تسمية وصلة}}: 
|<nowiki>{{قيمة ويكي بيانات
|{{{VIAF|}}}
|قيمة موجودة=https://www.example.com/{{{VIAF|}}}
|خاصية = P214
|وصلة = https://www.example.com/$1
}}</nowiki>
|{{قيمة ويكي بيانات{{#تبديل:{{SUBPAGENAME}}|ملعب=/ملعب|#default=}}
|{{{VIAF|}}}
|قيمة موجودة=https://www.example.com/{{{VIAF|}}}
|معرف ويكي بيانات=Q2471
|خاصية = P214
|وصلة = https://www.example.com/$1
|مراجع=لا
}}
|<nowiki>{{قيمة ويكي بيانات
|{{{VIAF|}}}
|قيمة موجودة=https://www.example.com/{{{VIAF|}}}
|خاصية = P214
|وصلة = https://www.example.com/$1
|تسمية وصلة=مثال
}}</nowiki>
|{{قيمة ويكي بيانات{{#تبديل:{{SUBPAGENAME}}|ملعب=/ملعب|#default=}}
|{{{VIAF|}}}
|قيمة موجودة=https://www.example.com/{{{VIAF|}}}
|معرف ويكي بيانات=Q2471
|خاصية = P214
|وصلة = https://www.example.com/$1
|تسمية وصلة=مثال
|مراجع=لا
}}
}}

=== الوصلات الخارجية url ===

{{توصيف
|عنوان= مسار كامل من ويكي بيانات، ونريد وضع لها تسمية، باستخدام {{وسيط قالب|urllabel}}: 

|<nowiki>{{قيمة ويكي بيانات
|خاصية=P856
|معرف ويكي بيانات=Q5284
}}
</nowiki>
|{{قيمة ويكي بيانات{{#تبديل:{{SUBPAGENAME}}|ملعب=/ملعب|#default=}}
|خاصية=P856
|معرف ويكي بيانات=Q5284
}}
|<nowiki>{{قيمة ويكي بيانات
|خاصية=P856
|معرف ويكي بيانات=Q5284
|urllabel=الموقع الرسمي
}}
</nowiki>
|{{قيمة ويكي بيانات{{#تبديل:{{SUBPAGENAME}}|ملعب=/ملعب|#default=}}
|خاصية=P856
|معرف ويكي بيانات=Q5284
|urllabel=الموقع الرسمي
}}
}}
{{توصيف
|عنوان= قيمة موجودة محلياً:

|<nowiki>{{قيمة ويكي بيانات
|https://linkedin.com/in/presidentbarackobama
|خاصية=P856
|معرف ويكي بيانات=Q5284
|urllabel=الموقع الرسمي
}}
</nowiki>
|{{قيمة ويكي بيانات{{#تبديل:{{SUBPAGENAME}}|ملعب=/ملعب|#default=}}
|https://linkedin.com/in/presidentbarackobama
|خاصية=P856
|معرف ويكي بيانات=Q5284
|urllabel=الموقع الرسمي
}}
}}

{{يستخدم ويكي بيانات2|قالب=قيمة ويكي بيانات|P1559}}

<includeonly>
[[تصنيف:قوالب ويكي بيانات]]
</includeonly>
<templatedata>
{
 "params": {
 "معرف ويكي بيانات": {
 "label": "معرف ويكي بيانات",
 "description": "معرف ويكي بيانات wikidata-item",
 "type": "string"
 },
 "خاصية": {
 "description": "خاصية ويكي بيانات wikidata-property",
 "type": "string"
 }
 },
 "description": "يظهر قيمة خاصية ويكي بيانات لعنصر الصفحة الحالية أو لعنصر آخر"
}
</templatedata>