تر ۰۱:۱۵, ۱۱ اپريل ۲۰۲۲ پورې شته مخليدنه، د Reedy (WMF)(خبرې اترې | ونډې)(Reedy (WMF) changed the content model of the page Module:Wikidata2/doc from "ويکي متن" to "ساده متن": T304381) لخوا ترسره شوې
{{ژر}}
هذه الوحدة نسخت في البداية من [[:sv:Modul:Wikidata2]] ومن ثم تم تطويرها هنا.
[[sv:Modul:Wikidata2]]
== الاستخدامات ==
أنظر قائمة [https://ar.wikipedia.org/w/index.php?title=Speci%C3%A1ln%C3%AD%3AHled%C3%A1n%C3%AD&profile=advanced&fulltext=Search&search=insource%3A%2F%28invoke%7Cاستدعاء%29%3AWikidata2%5C%7C%2F&ns10=1&profile=advanced قوالب]<!--a modulů--> تستخدم هذه الوحدة.
== الاستعمال ==
مثال
<pre>
{{#invoke:Wikidata2|formatStatements|property=p17}}
</pre>
== الوسائط ==
=== formatStatements ===
<!--
{{مخفي
|عنوان= شرح
|رصف نص2=right
|محتوى=-->
* {{Para|property}} '''مطلوب''' الخاصية المطلوبة.
* {{Para|entityId}} معرف عنصر ويكي بيانات.
* {{Para|page}} يمكن إستخدامه بدلاً من {{Para|entityId|Q805}} كالتالي: {{Para|page|اليمن}} .
* {{Para|enbarten}} أو {{Para|firstvalue}} يعرض أول قيمة فقط في الخاصية.
* {{Para|separator}} فاصلة بين البنود {{Para|separator=<br/>}} انظر أيضا <code> <nowiki>conjunction</nowiki> </code>
* {{Para|conjunction}} الفاصلة الأخيرة قبل اخر بند، افتراضي <code> <nowiki>، و</nowiki> </code>.
*{{Para|prefix}} بادئة
*{{Para|suffix}} لاحقة
*{{Para|formatting}} يحدد تنسيق القيم يستخدم مع [[#{{int:datatypes-type-globe-coordinate}}|{{int:datatypes-type-globe-coordinate}}]]، و[[#{{int:datatypes-type-wikibase-item}}|{{int:datatypes-type-wikibase-item}}]]، و[[#{{int:datatypes-type-wikibase-property}}|{{int:datatypes-type-wikibase-property}}]].
*{{Para|label}} اذا كنت تريد الاختيار كيفية ظهور الوصلات. مثلا <code> <nowiki>[[شعار مقاطعة بليكينج|الشعار]]</nowiki> </code> يمكن الحصول عليها عن طريق اضافة {{Para|label|الشعار}} تؤثر هذه المعلمة على الوحدات.
==== رتبة القيم / rank ====
*{{Para|rank}} يحدد نوع البيانات المطلوب عرضها:
<!--**{{Para|مفضلة/عادية/مهملة}} أنواع القيم في ويكي بيانات. -->
**{{Para|rank|all}} يظهر جميع البنود في الخاصية.
**{{Para|rank|valid}} يظهر البنود المفضلة والتي بوضع "ترتيب عادي" ولكن لا يظهر المهملة.
**{{Para|rank|best}} ('''افتراضي''') يظهر القيم المفضلة.
==== فرز النتيجة / sort ====
*{{Para|sortbytime}} الترتيب حسب الوقت يفيد هذا مع المعلمة {{Para|enbarten}} أعلاه
**{{Para|sortbytime|chronological}} ترتيب البنود حسب زمن التصفيات المذكورة.
**{{Para|sortbytime|inverted}} عكس البنذ السابق.
*{{Para|sortingproperty}} تحديد الخواص المدعومة، الافتراضي هو:<code><nowiki>'P585','P571','P580','P569','P582','P570'</nowiki> </code>بالترتيب، الخواص المعتمدة حالياً هي خواص الوقت. {{p|P585}} ،{{p|P571}} ،{{p|P580}} ،{{p|P569}} ،{{p|P582}} ،{{p|P570}}.
*{{Para|sortingproperty|sortbyarbitrary}} فرز القيم بواسطة تاريخ العناصر المرتبطة مثل تاريخ ولادة أبناء شخص "الأطفال". القيم المسموح بها هي:
**{{Para|sortingproperty|chronological}}
**{{Para|sortingproperty|inverted}} . وتعطى مع الخاصية المراد تفتيشها '<code> <nowiki>sortingproperty</nowiki> </code> اعلاه'.
==== المراجع / references ====
*{{Para|noref}} أدخل قيمة في هذه المعلمة إذا كنت لا تريد جلب المصادر من ويكي بيانات.
*{{Para|justref}} أدخل قيمة في هذه المعلمة إذا كنت تريد جلب المصادر {{أحمر|فقط }} دون ظهور القيمة!.
*{{Para|onlyvaluewithref }} لإظهار البيانات التي لها مراجع فقط.
==== صياغة النص====
*{{Para|formatcharacters}} تحديد صيغة اخراج القيمة، القيم المسموح بها هي: <code> <nowiki>lc/uc/lcfirst/ucfirst/formatnum</nowiki> </code>
**{{Para|formatcharacters|lc}}: تحويل جميع أحرف النص الإنجليزي إلى حروف صغيرة.
**{{Para|formatcharacters|lcfirst}}: تحويل الحرف الأول من النص الإنجليزي إلى حرف صغير.
**{{Para|formatcharacters|uc }}: تحويل جميع أحرف النص الإنجليزي إلى حروف كبيرة.
**{{Para|formatcharacters|ucfirst}}: تحويل الحرف الأول من النص الإنجليزي إلى حرف كبير.
**{{Para|formatcharacters|formatnum}}: مشروحة في [[#كمية]].
<!--**{{Para|FormatfirstCharacter }} كما أعلاه ولكن يؤثر فقط على أول القيم. -->
==== تصفيات / qualifiers ====
*{{Para|avoidqualifier}} يتجاهل القيم التي تحتوي تصفيات معينة، مثل: {{Para|avoidqualifier|P518}} يظهر البند الذي لا يحتوي على تصفية {{p|P518}}.
*{{Para|withdate}} يضيف تصفية {{P|P585}} إذا كانت موجودة.
*{{Para|bothdates}} يضيف تصفيات {{P|P580}} و{{P|P582}} إذا كانتا موجودتان كلاهما أو إحداهما.
**{{Para|bothdates|line}} يضع سطر جديد قبل التاريخ.
**{{Para|bothdates|before}} يضع التاريخ قبل القيمة.
<!--
*{{Para|withutgivort}} يضيف تصفية {{P|P291}} إذا كانت موجودة.
**{{Para|withutgivort |قوسين}} يضع القيمة بين قوسين ويصغرها.
-->
*{{Para|qual1}} يضيف تصفية محددة.
**{{Para|qual1|P1545}} يضيف تصفية {{P|P1545}} الى بنود الخاصية، مثال:منصب باراك أوباما + ترتيبه:
***<code><nowiki>{{#invoke:Wikidata2|formatStatements|entityId=Q76|property=P39|qual1=P1545|noref=true|rank=best}}</nowiki></code> ينتج :← [[رئيس الولايات المتحدة]] <small>(44)</small>
<!--{{توصيف1
|<nowiki>{{#invoke:Wikidata2|formatStatements|entityId=Q76|property=P39|qual1=P1545|noref=true|rank=best}}</nowiki>
|{{#invoke:Wikidata2|formatStatements|entityId=Q76|property=P39|qual1=P1545|noref=true|rank=best}}
}}-->
*{{Para|preferqualifier}} تحديد خاصية تصفيات يجب أن تكون بيانات الخاصية متضمنتها.
*{{Para|preferqualifiervalue}} تحدد القيمة التي تناسب أعلاه. يدعم حالياً العناصر فقط.
<!--
*{{Para|getsimpleproperty}} لاسترداد المعلومات من كائن مرتبط. تمنع هذه الوظيفة تكرار القيم يمكن أن تكون ''en'' .
**{{Para|getproperty}} ادخل هنا التي الخاصية لاسترداد <code> <nowiki>getsimpleproperty</nowiki> </code>
**{{Para|getenbarten}} ادخل هنا إذا واحد أو جميع البيانات يمكن عرضها <code> <nowiki>getsimpleproperty</nowiki> </code>
**{{Para|getmodifytime}} هنا يمكنك تحديد تنسيق الوقت <code> <nowiki>getsimpleproperty</nowiki> </code>
**{{Para|getraw}} كما "raw" ادناه
*{{Para|raw}} är en parameter som kan användas från andra moduler. Den resulterar i att utdatan kommer i en tabell.
*{{Para|novalue}} تحديد كيفية عرض القيم الغير متوفرة. 'nil' يعطي قيمة فارغة.
*{{Para|somevalue}} كما "novalue" اعلاه
*{{Para|relevans}} لن يتم اظهار البنود التي ليس بها وصلات إلى arwiki
-->
<!--
}} -->
==== وسائط حسب نوع البيانات / datatype ====
===== {{int:datatypes-type-wikibase-item}} / item =====
*{{Para|nolink}} يظهر النتيجة دون وصلات.
*{{Para|getonly}} يستخدم هذا الوسيط إذا أردنا الحصول على عناصر معينة التي تكون قيمة {{P|P31}} فيها تساوي قيمة هذا الوسيط، مثال:
**{{para|getonly|Q5}} للحصول على الأفراد فقط.
**القيم المتعددة ممكنة، مثل :{{para|getonly|Q127448,Q193556}} للحصول على البلديات السويدية والمناظر الطبيعية.
*{{Para|getonlyproperty}} إذا أردنا استخدام خاصية أخرى بدلاً من {{P|P31}} في البند السابق.
*{{Para|formatting|raw}} يعرض القيمة بشكل Q505.
*{{Para|formatting|sitelink}} ينتج الوصلة إذا كانت موجودة في الويكي العربية.
===== {{int:datatypes-type-commonsMedia}} / commonsMedia =====
* تظهر الصور افتراضياً كالتالي:
{{توصيف1|<nowiki>{{#invoke:Wikidata2|formatStatements|entityId=Q76|property=P18|noref=true|rank=best}}</nowiki>|{{#invoke:Wikidata2|formatStatements|entityId=Q76|property=P18|noref=true|rank=best}}}}
* {{para|image}} عند استخدام هذا الوسيط في خواص الصور تظهر الصورة مباشرة.
* {{para|size}} لتحديد حجم الصورة (60 افتراضياً)، ضع القيمة دون (بك/px إلخ).
{{توصيف
|<nowiki>{{#invoke:Wikidata2|formatStatements|entityId=Q76|property=P18|image=true|noref=true|rank=best|size=100}}</nowiki>
|{{#invoke:Wikidata2|formatStatements|entityId=Q76|property=P18|image=true|noref=true|rank=best|size=100}}
}}
===== {{int:datatypes-type-globe-coordinate}} / coordinate =====
*{{Para|formatting|latitude}} يعرض خط العرض فقط.
*{{Para|formatting|longitude}} يعرض خط الطول فقط.
*{{Para|formatting|precision}} يعرض الدقة.
*{{Para|formatting|globe}} يعرض عنصر الكوكب. مثال:
{{توصيف
|<nowiki>{{#invoke:Wikidata2|formatStatements|entityId=Q805|property=P625|formatting=globe}}</nowiki>
|{{#invoke:Wikidata2|formatStatements|entityId=Q805|property=P625|formatting=globe}}
}}
<!--*{{Para|formatting|dimension}} يعرض فقط.-->
===== نص أحادي اللغة / {{int:datatypes-type-monolingualtext}} / monolingualtext =====
*{{Para|langpref}} في الوحدة، هناك مرشح يعطي أولوية للقيم التي تحتوي على "اللغة = العربية". أضف القيمة المطلوبة لتعطيل هذا الفلتر.
*{{Para|langpref|justlang}} لإظهار لغة النص فقط دون النص.
*{{Para|showlang}} استخدم أي قيمة لإظهار النص حسب تنسيق [[قالب:رمز لغة واسمها]].
===== {{int:datatypes-type-quantity}} / quantity =====
*{{Para|nounitlink}} يظهر وحدة القياس دون وصلة.
*{{Para|noshortunit}} لا يظهر الوحدات مختصرة. مثلاً لا يظهر كم بدلاً عن كيلومتر.
*{{Para|formatcharacters|formatnum}}: تنسيق الأرقام بالفواصل.
{{توصيف
|<nowiki>{{#invoke:Wikidata2
|formatStatements
|entityId=Q805
|property=P2046
|noref=t
|firstvalue=y
}}</nowiki>
|{{#invoke:Wikidata2|formatStatements|entityId=Q805|property=P2046|noref=t|firstvalue=y}}
|<nowiki>{{#invoke:Wikidata2
|formatStatements
|entityId=Q805
|property=P2046
|firstvalue=y
|noref=t
|formatcharacters=formatnum
}}</nowiki>
|{{#invoke:Wikidata2|formatStatements|entityId=Q805|property=P2046|firstvalue=y|noref=t|formatcharacters=formatnum}}
}}
===== {{int:datatypes-type-string}} / string=====
===== {{int:datatypes-type-time}} / time=====
*{{Para|modifytime}} يحدد تنسيق الوقت أو التاريخ:
**{{Para|modifytime|longdate}} يكتب التاريخ في شكل "{{#time:j F Y}}"
**{{Para|modifytime|Y}} يكتب التاريخ في شكل "{{#time:Y}}" يظهر فقط السنة.
**{{Para|modifytime| F}} يكتب التاريخ في شكل "{{#time:F}}" يظهر فقط الشهر.
**{{Para|modifytime| j}} يكتب التاريخ في شكل "{{#time:j}}" يظهر فقط اليوم.
*{{Para|modifyqualifiertime}} تنسيق التاريخ على النحو الوارد أعلاه، ولكن يؤثر فقط على [[#تصفيات|التصفيات]]. <code> <nowiki>qualifier</nowiki> </code>
===== {{int:datatypes-type-external-id}} / external-id =====
*{{Para|pattern}} طريقة عرض الخاصية مثلاً في وصلات الضبط الاستنادي <code> <nowiki>$1</nowiki> </code> مثلاً: <code> <nowiki><nowiki>https://viaf.org/viaf/$1/</nowiki></nowiki> </code>.
**{{Para|pattern|autourl}} من خواص البند أعلاه، لنمط مستخدم في الخاصية {{P|P1630}} (تنسيق عنوان URL) للخاصية المطلوبة.
**{{Para|pattern|autourl2}} كما سبق، يقدم وصلة من نوع <code> <nowiki><nowiki>[https://viaf.org/viaf/$1/ $1]</nowiki> </nowiki> </code>
===== {{int:datatypes-type-url}} / url =====
*{{Para|urllabel}} وضع تسمية لتظهر بدلاً من الوصلة، كما في [[#{{int:datatypes-type-external-id}}|{{int:datatypes-type-external-id}}]] ولكن في خواص الروابط.
**مثال عند استخدام {{P|P2035}} ل{{Q|Q76}} مع/بدون الوسيط {{Para|urllabel|لينكد إن}}:
:{{توصيف
|<nowiki>{{#invoke:Wikidata2|formatStatements|entityId=Q76|property=P2035}}</nowiki>
|{{#invoke:Wikidata2|formatStatements|entityId=Q76|property=P2035}}
|<nowiki>{{#invoke:Wikidata2|formatStatements|urllabel=لينكد إن|entityId=Q76|property=P2035}}</nowiki>
|{{#invoke:Wikidata2|formatStatements|urllabel=لينكد إن|entityId=Q76|property=P2035}}
}}
<!--
===== {{int:datatypes-type-wikibase-property}} / wikibase-property =====
===== {{int:datatypes-type-math}} / math=====
===== {{int:datatypes-type-geo-shape}} / geo-shape=====
===== {{int:datatypes-type-tabular-data}} / tabular-data=====
-->
=== pageId ===
: <code><nowiki>{{#invoke:Wikidata2|pageId}}</nowiki></code>
ينتج عنصر ويكي بيانات للصفحة المستخدم فيها الكود.
:{{#invoke:Wikidata2|pageId}}
=== getSiteLink===
*{{Para|2}} أو {{Para|site}} الموقع مثل {{مونو|enwiki}}.
*يتم أخذ عنصر ويكي بيانات من أحد الوسائط التالية:
*#{{Para|1}} أو {{Para|id}} عنصر ويكي بيانات.
*# {{Para|page}} يمكن استخدام اسم الصفحة في هذه الويكي بدلاً من استخدام الوسيط {{Para|id}}.
*{{Para|rank|countsitelinks}} يستخدم فقط لإظهار عدد وصلات اللغات.
مثال: <code><nowiki>{{#invoke:Wikidata2|getSiteLink|Q76}}</nowiki></code> ينتج: {{#invoke:Wikidata2|getSiteLink|Q76}}
مثال: <code><nowiki>{{#invoke:Wikidata2|getSiteLink|Q76|enwiki}}</nowiki></code>
أو: <code><nowiki>{{#invoke:Wikidata2|getSiteLink|id=Q76|site=enwiki}}</nowiki></code>
:ينتج: {{#invoke:Wikidata2|getSiteLink|id=Q76|site=enwiki}}
أو:
{{توصيف2
|<nowiki>{{#invoke:Wikidata2
|getSiteLink
|page=اليمن
|site=enwiki
}}</nowiki>
|{{#invoke:Wikidata2
|getSiteLink
|page=اليمن
|site=enwiki
}}
}}
=== Dump ===
مثال: <code><nowiki>{{#invoke:Wikidata2|Dump|claims|P19}}</nowiki></code>
:مثال2: <code><nowiki>{{#invoke:Wikidata2|Dump|id=Q76|claims|P19}}</nowiki></code>
{{مخفي
|عنوان= مثال
|رصف نص2=left
|محتوى= {{#invoke:Wikidata2|Dump|id=Q76|claims|P19}}
}}
:مثال موسع: <code><nowiki>{{#invoke:Wikidata2|Dump|claims|P1791|1|references|1|snaks|P244|1|datavalue|value}}</nowiki></code>
=== isSubclass / نوع فرعي من ===
إن كانت قيمة {{P|P31}} أو {{P|P279}} للصفحة التي وضع فيها الكود أو للصفحة في الوسيط {{para|id}} مساوية للوسيط {{para|parent}} ينتج 'true' غير ذلك لا ينتج شيئاً.
كامل الخيارات:<code><nowiki>{{#invoke:Wikidata2|isSubclass|parent=|maxDepth=1|property=|id=|exitItem=}}</nowiki></code>
*'''مطلوب:''' {{para|parent}} مثلاً {{Q|Q5}}
* {{para|maxDepth}} عمق البحث في الصفحات.
* {{para|property}} الخاصية المطلوبه (افتراضياً {{P|P31}}، و{{P|P279}})
* {{para|id}} الصفحة المطلوب البحث فيها.
* {{para|exitItem}}
مثال:
{{توصيف
|<nowiki>{{#invoke:Wikidata2|isSubclass|parent=Q5|maxDepth=1|id=Q76}}</nowiki>
|{{#invoke:Wikidata2|isSubclass|parent=Q5|maxDepth=1|id=Q76}}
|<nowiki>{{#invoke:Wikidata2|isSubclass|parent=Q45|maxDepth=5|id=Q76}}</nowiki>
|{{#invoke:Wikidata2|isSubclass|parent=Q45|maxDepth=5|id=Q76}}
}}
=== EntityIdForTitle ===
يعطي معرف ويكي بيانات من خلال عنوان المقالة:
مثال:
* <code><nowiki>{{#invoke:Wikidata2|EntityIdForTitle|اليمن}}</nowiki></code>
**ينتج: {{#invoke:Wikidata2|EntityIdForTitle|اليمن}}
* <code><nowiki>{{#invoke:Wikidata2|EntityIdForTitle|وحدة:Wikidata2}}</nowiki></code>
**ينتج: {{#invoke:Wikidata2|EntityIdForTitle|وحدة:Wikidata2}}
[[تصنيف:وحدات ويكي بيانات]]
