قالب:عرض بيانات بلد

توثيق القالب[عرض] [عدل] [تاريخ] [مسح الكاش] [استخدامات]

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

الاستخدام

يتم استدعاء هذا القالب تلقائيا عن طريق بناء الجملة القياسي من قالب بيانات بلد:

{{ {{{1<noinclude>|عرض بيانات بلد</noinclude>}}}
| alias = Countryname
| shortname alias = Shortcountryname  <!-- only necessary if Shortcountryname ≠ Countryname, otherwise omit -->
| flag alias = Flag of Countryname.svg
| size = {{{size|}}}
| name = {{{name|}}}
| variant = {{{variant|}}}  <!-- only necessary if there is one or more flag alias-variant parameters, otherwise omit -->
}}

الوسيط الاولانى في قالب بيانات بلد عادة ما يكون اسم تنسيق القالب الفوقي. على سبيل المثال قالب:علم يستخدم قالب:علم/صميم ليقوم فعلياً بتشكيل أيقونة العلم ووصلة الويكي. إذا كان الوسيط الاولانى مفقوداً، والذي في هذه الحالة سيتم عرض قالب بيانات بلد مباشرة، فإن هذا الجزء من برمجة القالب {{{1<noinclude>|country showdata</noinclude>}}} يضمن أن هذا القالب سيتم استخدامة كقيمة افتراضية للوسيط الأول. هذه التقنية تضمن أن تقوم قوالب بيانات بلد بتوثيق نفسها إذا ما تم استخدام النص المعياري.

الوسائط الإضافية

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

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

متغيرات العلم

يتم إضافة متغيرات العلم إلى قالب بيانات بلد من خلال تضمين واحد أو أكثر من محددات flag alias-عنوان، حيث كل عنوان هو محدد فريد يتم استخدامه لاحقاً في إدخال المحددات إلى {{علم|...}}، , {{رمز علم|...}}، إلخ. لتوثيق متغيرات العلم، استخدم محدد التوثيق varN لتحديد كل عنوان.

على سبيل المثال قالب:بيانات سيشيل تقوم بتحديد ثلاث متغيرات للعلم (إضافة إلى العلم الحالي) وذلك من خلال الكود التالي:

| 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

ويتم توثيق هذه المتغيرات من خلال القسم التالي لاحقاً في القالب:

<noinclude>
| var1 = 1976
| var2 = 1977
| var3 = colonial
...
</noinclude>

يمكن توثيق حتى خمسة عشر علماً مختلفاً باستخدام هذه الطريقة (باستخدام var1 حتى var15). في حال وجود أكثر من ذلك، يمكن سرد هذه المتغيرات في صفحة توثيق فرعية منفصلة.

لاحظ أنك لست بحاجة لاستخدام محددات varN للمتغيرات المعيارية الاختيارية كتسميات naval‏، air force‏و army (وهي تستخدم لشعارات البحرية، القوى الجوية، والجيش على التسلسل). في حال اسخدام هذه المتغيرات فسيتم توثيقها بشكل آلي.

Redirect aliases

تحتوي العديد من قوالب بيانات البلد على أسماء "اسم مستعار" يمكن استخدامها بدلاً من اسم البلد المعتاد مع كل قوالب العلم الرئيسية. هذه عادة ما تكون ، ولكن ليس حصريًا ، اختصارات رمز الدولة القياسية مثل تلك المحددة في أيزو 3166-1 حرفي-3 أو بواسطة IOC أو قائمة البلدان حسب الرموز الفيفا. يتم تنفيذ هذه عمليات إعادة التوجيه ، ويتم سردها في Category: تحويلات قوالب بيانات بلد.

على سبيل المثال ، Template: Country data DEU و Template: Country data GER كلاهما يعيدان التوجيه إلى قالب: Country data Germany ، لأن "DEU" هو رمز ISO و "GER" هو رمز IOC و FIFA لألمانيا. لذلك ، {{رمز علم | DEU}} ، {{رمز علم | GER}} ، و < tt> {{رمز علم | ألمانيا}} جميعها لها نفس النتيجة. يتم توثيق الأسماء المستعارة لإعادة التوجيه هذه بواسطة جزء شفرة القالب التالي:

<noinclude>
...
| redir1 = DEU
| redir2 = GER
...
</noinclude>

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

Related templates

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

على سبيل المثال ، قالب: Country data Serbia and Montenegro يتضمن الكود التالي لتوثيق ثلاثة قوالب بيانات خاصة بالدول التانيه:

<noinclude>
...
| related1 = Serbia
| related2 = Montenegro
| related3 = FR Yugoslavia
...
</noinclude>

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

Flag article link

يعرض هذا القالب صورة علامة كبيرة على يمين مربع الوثائق ، مع وجود رابط لمقال حول العلامة في التسمية التوضيحية إذا كان موجودًا. الصفحة التي يتم تقييمها هي "Flag of {{{ alias}}}" ، بقيمة |alias= في رمز القالب الذي يستبدل {{{ alias}}}. إذا كان هناك مقال حول العلامة على الرغم من أن "علم {{{ alias}}}" غير موجود ، فقم إما بإنشاء الأخير كإعادة توجيه إلى الصفحة الصحيحة أو أضف المعلمة التالية:

<noinclude>
...
| flag link = ''Article name''
...
</noinclude>

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

Additional documentation

في الحالات التي لا تكون فيها طريقة التوثيق التلقائي كافية تمامًا ، يمكن عرض وثائق إضافية بواسطة country showdata. ما عليك سوى إنشاء صفحة فرعية للوثائق (named as Template:Country data Countryname/doc) مع المواد الإضافية ، وسيتم نقلها بعد جميع أقسام الإخراج التانيه. فمثلا:

• قالب:Country data Ireland/doc يُستخدم لشرح سبب اختلاف هذا القالب عن Template: Country data Republic of Ireland
• قالب:Country Data France/doc يُستخدم لتوثيق قائمة قوالب بيانات الدولة المتاحة لكل منطقة من مناطق فرنسا
• قالب:Country Data United States/doc يُستخدم لتوثيق المجموعة الكاملة من متغيرات العلم (لكل عدد من النجوم) ، ولإدراج جميع قوالب بيانات البلد المتاحة لعلامات الولايات والأقاليم

Categorization

This template automatically categorizes pages it is transcluded on in Category:جميع قوالب بيانات بلد and in the tracking categories in Category:Country data tracking categories. Content categories, such as those by country or by type/status, should be added manually by putting them inside <includeonly></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 <includeonly> tags and save the page.

The default sort key used for the automatic categories is the part after Template:Country data in the page title (overwritten by the deprecated |templatename= parameter if specified). The parameter |cat= can be used to specify a custom ASCII sorting key for these categories. For example, قالب:Country data Åland Islands and Template:Country data Republic of Ireland use this parameter to sort them under "A" and "I" respectively.