Gerges: ٢٣ مراجعة

2021-03-27T01:15:36Z

٢٣ مراجعة

صفحة جديدة

{{صفحة توثيق فرعية}}
إن هذا القالب يستخدم لتوثيق القوالب المستخدمة من قبل [[:تصنيف:قوالب أعلام|قوالب أعلام]]. إن نتائج هذا القالب يمكن ملاحظتها مباشرة من خلال أي من القوالب في [[:تصنيف:قوالب بيانات بلد]].

==الاستخدام==
يتم استدعاء هذا القالب تلقائيا عن طريق بناء الجملة القياسي من قالب بيانات بلد:
<pre>
{{ {{{1<noinclude>|عرض بيانات بلد</noinclude>}}}
| alias = Countryname
| shortname alias = Shortcountryname 
| flag alias = Flag of Countryname.svg
| size = {{{size|}}}
| name = {{{name|}}}
| variant = {{{variant|}}} 
}}
</pre>
الوسيط الأول في قالب بيانات بلد عادة ما يكون اسم تنسيق ''القالب الفوقي''. على سبيل المثال [[قالب:علم]] يستخدم [[قالب:علم/صميم]] ليقوم فعلياً بتشكيل أيقونة العلم ووصلة الويكي. إذا كان الوسيط الأول مفقوداً، والذي في هذه الحالة سيتم عرض قالب بيانات بلد مباشرة، فإن هذا الجزء من برمجة القالب <code><nowiki>{{{1<noinclude>|country showdata</noinclude>}}}</nowiki></code> يضمن أن ''هذا'' القالب سيتم استخدامة كقيمة افتراضية للوسيط الأول. هذه التقنية تضمن أن تقوم قوالب بيانات بلد ''بتوثيق نفسها'' إذا ما تم استخدام النص المعياري.

==الوسائط الإضافية==
العديد من قوالب تتطلب توثيقاً إضافياً يتجاوز الوسائط <tt>alias</tt> و <tt>flag alias</tt> الإلزامية المعيارية. يقوم هذا القالب تلقائياً بتوثيق الوسائط الاختيارية المعيارية (مثل <tt>shortname alias</tt>) في حال استخدامها. كما يمكن توثيق الوسائط الاختيارية الفريدة (مثل وسائط <tt>flag variant</tt>) إذا ماتم تضمينها. هذه الطريقة الأخيرة تستخدم وسائط محددة التوثيق في قالب بينات بلد لتفعيل المخرج الإضافي لهذا القالب. وسائط التوثيق هذه مفصولة عن باقي وسائط قالب بيانات بلد بواسطة المقطع <tt><nowiki><noinclude></nowiki></tt>

<pre>
<noinclude>
| var1 = ...
| redir1 = ...
| related1 = ...
</noinclude>
</pre>

===متغيرات العلم===
يتم إضافة متغيرات العلم إلى قالب بيانات بلد من خلال تضمين واحد أو أكثر من محددات <tt>flag alias-''عنوان''</tt>، حيث كل <tt>''عنوان''</tt> هو محدد فريد يتم استخدامه لاحقاً في إدخال المحددات إلى <tt><nowiki>{{علم|...}}</nowiki></tt>، , <tt><nowiki>{{رمز علم|...}}</nowiki></tt>، إلخ. لتوثيق متغيرات العلم، استخدم محدد التوثيق <tt>var''N''</tt> لتحديد كل عنوان.

على سبيل المثال [[قالب:بيانات بلد سيشل]] تقوم بتحديد ثلاث متغيرات للعلم (إضافة إلى العلم الحالي) وذلك من خلال الكود التالي:
<pre>
| flag alias-1976 = Flag of the Seychelles 1976.svg
| flag alias-1977 = Flag of the Seychelles 1977.svg
| flag alias-colonial = Government Ensign of the United Kingdom.svg
</pre>
ويتم توثيق هذه المتغيرات من خلال القسم التالي لاحقاً في القالب:

<pre>
<noinclude>
| var1 = 1976
| var2 = 1977
| var3 = colonial
...
</noinclude>
</pre>
يمكن توثيق حتى خمسة عشر علماً مختلفاً باستخدام هذه الطريقة (باستخدام <tt>var1</tt> حتى <tt>var15</tt>). في حال وجود أكثر من ذلك، يمكن سرد هذه المتغيرات في صفحة توثيق فرعية منفصلة.

لاحظ أنك ''لست'' بحاجة لاستخدام محددات <tt>var''N''</tt> للمتغيرات المعيارية الاختيارية كتسميات <tt>naval</tt>{{فاصل}}، <tt>air force</tt>{{فاصل}}و <tt>army</tt> (وهي تستخدم لشعارات البحرية، القوى الجوية، والجيش على التسلسل). في حال اسخدام هذه المتغيرات فسيتم توثيقها بشكل آلي.

===Redirect aliases===
Many country data templates have ''alias'' names that can be used instead of the usual country name with all of the main flag templates. These are usually, but not exclusively, standard country code abbreviations such as those specifed in [[أيزو 3166-1 حرفي-3]] or by the [[قائمة رموز بلدان اللجنة الأولمبية الدولية|IOC]] or [[قائمة البلدان حسب رموز الفيفا]]. These are implemented as redirects, and are listed in [[:Category:تحويلات قوالب بيانات بلد]].

For example, [[Template:Country data DEU]] and [[Template:Country data GER]] both redirect to [[قالب:بيانات بلد ألمانيا]], because ''DEU'' is the ISO code and ''GER'' is the IOC and FIFA code for Germany. Therefore, <tt><nowiki>{{رمز علم|DEU}}</nowiki></tt>, <tt><nowiki>{{رمز علم|GER}}</nowiki></tt>, and <tt><nowiki>{{رمز علم|ألمانيا}}</nowiki></tt> all have the same result. These redirect aliases are documented by the following template code fragment:
<pre>
<noinclude>
...
| redir1 = DEU
| redir2 = GER
...
</noinclude>
</pre>

Up to five flag redirects can be documented by this method (using <tt>redir1</tt> to <tt>redir5</tt>).

===Related templates===
Several country data templates are used for alternative forms to the common country data template for the nation, usually but not exclusively for historic nations. Pointers to these alternative templates are useful additions to the template documentation so that editors can use the correct template for their specific purposes.

For example, [[Template:Country data Serbia and Montenegro]] includes the following code to document three other related country data templates:
<pre>
<noinclude>
...
| related1 = Serbia
| related2 = Montenegro
| related3 = FR Yugoslavia
...
</noinclude>
</pre>


Up to six related flags can be documented by this method (using <tt>related1</tt> to <tt>related6</tt>).

===Flag article link===
This template shows a large flag image on the right of the documentation box, with a link to an article about the flag in the caption if it exists. The page that it evaluates is "Flag of {{param|alias}}", with the value of {{وسيط قالب|alias}} in the template code replacing {{param|alias}}. If there is an article about the flag even though "Flag of {{param|alias}}" does not exist, either create the latter as a redirect to the correct page or add the following parameter:
<pre>
<noinclude>
...
| flag link = ''Article name''
...
</noinclude>
</pre>

This can also be used to override the automatic link if "Flag of {{param|alias}}" does exist but leads to the wrong article.

===Additional documentation===
For situations where the automatic documentation method is not completely adequate, additional documentation can be displayed by <tt>country showdata</tt>. Simply create a documentation subpage (named as <tt>Template:Country data Countryname/doc</tt>) with the additional material, and it will be transcluded after all other output sections.

For example:
*[[Template:Country data Ireland/doc]] is used to explain why that template is distinct from [[Template:Country data Republic of Ireland]]
*[[Template:Country data France/doc]] is used to document the list of country data templates available for each of the regions of France
*[[Template:Country data United States/doc]] is used to document the full set of flag variants (for each number of stars), and to list all of the country data templates available for state and territory flags

===Categorization===
This template automatically categorizes pages it is transcluded on in [[:تصنيف:جميع قوالب بيانات بلد]] and in the tracking categories in [[:Category:Country data tracking categories]]. Content categories, such as those [[:تصنيف:قوالب بيانات بلد حسب البلد]] or [[:تصنيف:قوالب بيانات بلد حسب نوع الكيان]], should be added manually by putting them inside {{Tag|includeonly}} tags on a template's documentation subpage. If a template does not have a documentation page yet, click on the "/doc" link at the bottom of the automatic documentation, add categories between the preloaded {{Tag|includeonly|open}} tags and save the page.

The default sort key used for the automatic categories is the part after <code>Template:Country data</code> in the page title. The parameter {{وسيط قالب|cat}} can be used to specify a custom ASCII sorting key for these categories. For example, [[قالب:بيانات بلد جزر أولاند]] and [[قالب:بيانات بلد جمهورية أيرلندا]] use this parameter to sort them under "A" and "I" respectively.

Automatically added by this template:
* {{سطر تصنيف وصفحاته|جميع قوالب بيانات بلد}}
* {{سطر تصنيف وصفحاته|Country data template sandboxes}}
* {{سطر تصنيف وصفحاته|Country data templates with distinct default size}}
* {{سطر تصنيف وصفحاته|Country data templates with distinct shortname}}
* {{سطر تصنيف وصفحاته|قوالب بيانات بلد مع اسم مختصر محدد}}
* {{سطر تصنيف وصفحاته|Country data templates with documentation subpage}}
* {{سطر تصنيف وصفحاته|Country data templates without flag alias}}
* {{سطر تصنيف وصفحاته|Uncategorized country data templates}}

Manually added to templates or documentation pages:
* {{سطر تصنيف وصفحاته|قوالب بيانات بلد عن البلدان}}
* {{سطر تصنيف وصفحاته|قوالب بيانات بلد للتقسميات الإدارية}}
* {{سطر تصنيف وصفحاته|Country data templates of cities}}
* {{سطر تصنيف وصفحاته|Country data templates of continents}}
* {{سطر تصنيف وصفحاته|Country data templates of dependent territories}}
* {{سطر تصنيف وصفحاته|Country data templates of geographical regions}}
* {{سطر تصنيف وصفحاته|Country data templates of governments}}
* {{سطر تصنيف وصفحاته|Country data templates of historical entities}}
* {{سطر تصنيف وصفحاته|قوالب بيانات بلد منظمات دولية}}
* {{سطر تصنيف وصفحاته|Country data templates of micronations}}
* {{سطر تصنيف وصفحاته|Country data templates of other entities}}

<includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox |
| 
[[تصنيف:قوالب تنسيق قوالب الأعلام|{{اسم_الصفحة}}]]
[[تصنيف:قوالب استرجاع بيانات]]
}}</includeonly>

قالب:عرض بيانات بلد/شرح - تاريخ المراجعة

Gerges: ٢٣ مراجعة