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

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

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

الاستخدام

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

{{ {{{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 -->
}}

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

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

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

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

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

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

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

| 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 ، ، و < 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 يتضمن الكود اللى بعد كده لتوثيق 3 قوالب بيانات خاصة بالدول التانيه:

<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.