Changes

Jump to navigation Jump to search
4,804 bytes added ,  03:27, 27 September 2019
no edit summary
<noinclude>
<languages />
</noinclude><includeonly>{{#switch:<!--
-->| =<!--
--><code {{#if:{{{required|}}}|style="font-weight:bold"}} {{#if:{{{id|{{{1|{{{name|}}}}}}}}}|id="{{{id|{{{1|{{{name}}}}}}}}}"}}>{{{1|{{{name|}}}}}}</code>{{#if:{{{2|{{{description|}}}}}}|&#58; {{{2|{{{description|}}}}}}}}{{#if:{{{maxallowed|}}}|&#32;لا يسمح بما يزيد عن {{{maxallowed}}} ({{#if:{{{maxallowedbot|}}}|{{{maxallowedbot}}}|{{#switch:{{{maxallowed}}}|50=500|500=5000}}}} للبوتات).}}{{#if:{{{type|}}}|&#32;'''النوع:''' {{{type}}}}}{{#if:{{{values|}}}|&#32;القيم الممكنة: {{{values}}}}}{{#if:{{{default|}}}|&#32;(افتراضي: {{{default}}})}}{{#if:{{{version|}}}|&#32;{{MW version-inline|{{#switch:{{#if:{{{removed|}}}|R}}
|={{{version}}}+
|R={{{version}}}-{{{removed}}}
}}}}}}{{#if:{{{deprecated|}}}|&#32;{{deprecated-inline|1={{{deprecated}}}}}}}{{#if:{{{removed|}}}|&#32;{{removed-inline|{{{removed}}}}}}}<!--
-->| #default=<!--
-->{{#invoke:Template translation|renderTranslatedTemplate|template=Template:ApiParam|noshift=1}}<!--
-->}}</includeonly><noinclude>
{{Documentation|content=

:''يرجى التفكير جديا في رفع استدعاءات هذا القالب ووضع مكانها حالات ضم Special:ApiHelp ([[phab:T89318]]) منذ أن ملء متغيرات هذا القالب يكرر بلا داعي توثيق متغيرات واجهة برمجة التطبيقات في النص المصدر.''

== الاستخدام ==

يمكن استخدام هذا القالب في توثيق متغيرات واجهة برمجة التطبيقات.
الغرض منه هو توحيد هيئة قوالب المتغيرات على كافة صفحات واجهة برمجة التطبيقات.

{{Pre2|style=display:inline-block
|1=<nowiki>{{ApiParam
|</nowiki>''name=''<nowiki>
|</nowiki>''description=''<nowiki>
|required=
|maxallowed=
|maxallowedbot=
|type=
|values=
|default=
|version=
|deprecated=
|removed=
}}</nowiki>}}

<table class="wikitable sortable">
<tr><th colspan=2>متغيرات ApiParam</th></tr>
<tr><th>اسم المتغير</th><th>بيان</th></tr>
<tr><td><code>'''name'''</code> ''(أو أول متغير غير مسمى)''</td><td>اسم المتغير (إلزامي):</td></tr>
<tr><td><code>description</code> ''(أو ثاني متغير غير مسمى)''</td><td>بيان المتغير.</td></tr>
<tr><td><code>required</code></td><td>حدد قيمة لو كان المتغير مطلوبا. اسم المتغير المطلوب سوف يكون بخط أسود عريض.</td></tr>
<tr><td><code>maxallowed</code></td><td>لأغراض القيم المقسمة باستخدام شريط رأسي أو الكميات المكونة من أرقام، ما هو الحد الأقصى.</td></tr>
<tr><td><code>maxallowedbot</code></td><td>كما سلف، للبوتات. لو استخدمت 50 أو 500 لأغراض <code>maxallowed</code>، سوف تصبح القيمة الافتراضية هي 500 أو 5000 على التوالي.</td></tr>
<tr><td><code>type</code></td><td>نوع بيانات المتغير.</td></tr>
<tr><td><code>values</code></td><td>قائمة بالقيم المحتملة للمتغير.</td></tr>
<tr><td><code>default</code></td><td>القيمة الافتراضية للمتغير.</td></tr>
<tr><td><code>version</code></td><td>الإصدار الذي أضيف له هذا المتغير. استخدم رقم إصدار برمجيات ميدياويكي الصرف لا غير.</td></tr>
<tr><td><code>deprecated</code></td><td>الإصدار الذي أصبح فيه المتغير متقادما. استخدم رقم إصدار برمجيات ميدياويكي الصرف لا غير.</td></tr>
<tr><td><code>removed</code></td><td>الإصدار الذي رفع منه هذا المتغير. استخدم رقم إصدار برمجيات ميدياويكي الصرف لا غير.</td></tr>
</table>

== أمثلة ==
<pre style="display:inline-block">*{{ApiParam|rcid|One or more recent changes IDs from which to add or remove the tag.|maxallowed=50}}</pre>
*{{ApiParam|rcid|One or more recent changes IDs from which to add or remove the tag.|maxallowed=50}}

<pre style="display:inline-block">*{{ApiParam|siprop|Which properties to get|default=general}}
**{{ApiParam|general|General site information}}
***{{ApiParam|articlepath|{{ll|Manual:$wgArticlePath|$wgArticlePath}}|version=1.15}}</pre>
*{{ApiParam|siprop|Which properties to get|default=general}}
**{{ApiParam|general|General site information}}
***{{ApiParam|articlepath|{{ll|Manual:$wgArticlePath|$wgArticlePath}}|version=1.15}}

== طالع أيضا ==
* {{tl|Parameter}} &ndash; نسخة قديمة من ApiParam

}}
[[Category:Typing-aid templates{{#translation:}}]]
[[Category:Formatting templates{{#translation:}}]]
</noinclude>

Navigation menu