د Module:Wikidata2/doc سرچينه کتل

{{ژر}}
دا ماډيول په پيل کې له [[: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=&lt;br/&gt;}} انظر أيضا <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|الشعار}} تؤثر هذه المعلمة على الوحدات.
==== ارزښت درجه ====
*{{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}} / کواردېنات =====
*{{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}}
[[تصنيف:وحدات ويكي بيانات]]