Шаблон:Показ даних країни/документація

Це підсторінка документації шаблону {{Показ даних країни}}. Вона містить інформацію про використання, категорії та інший вміст, що не є частиною оригінальної сторінки шаблону.

Цей шаблон використовується для створення мета-шаблонів данні країни, які використовуються системою шаблонів прапорів.

Дивись Вікіпедія:ВікіПроєкт Шаблони Прапорів для отримання основної інформації та сторінку обговорення системи шаблонів прапорів.

Шаблон автоматично використовується при зазначенні стандартного синтаксиса даних шаблона:

{{ {{{1<noinclude>|показ шаблону даних</noinclude>}}}
| alias = Назва країні
| shortname alias = Коротка назва  <!-- використовуйте лише якшо Коротка назва ≠ Назві країни, наприклад, Росія - Російська імперія -->
| flag alias = Flag of Countryname.svg
| розмір = {{{розмір|}}}
| назва = {{{назва|}}}
| варіант = {{{варіант|}}}  <!-- лише якщо є декілька варіантів прапора, наприклад, морський, військовий, прапори різних років -->
}}

Перший параметр шаблону дані країни зазвичай це назва мета-шаблону форматування. Наприклад, Шаблон:ПрапорТекст використовує Шаблон:ПрапорТекст/ядро для створення зображення прапора і вікіпосилання. Якщо перший параметр відсутній, фрагмент коду шаблону {{{1<noinclude>|country showdata</noinclude>}}} повідомляє, що цей шаблон буде використовуватися як поточний перший параметр. Ця методика дозволяє шаблонам даних країни "само-документуватися" якщо використано стандартний синтаксис.

Багато шаблонів потребують додаткову документацію крім стандартних обов'язкових параметрів alias та flag alias. Цей шаблон буде автоматично документувати стандартні необов'язкові параметри (наприклад shortname alias) якщо є і може документувати унікальні додаткові параметри (наприклад, варіанти прапорів) якщо потрібно. Цей останній метод використовує параметри документації зазначені в шаблоні даних країни, щоб активувати додатковий вихід з цього шаблону. Ці задокументовані параметри відділені від інших параметрів кодом у секції <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-колоніальний = Government Ensign of the United Kingdom.svg

Ці варіанти задокументовані у наступній секції шаблону:

<noinclude>
| var1 = 1976
| var2 = 1977
| var3 = колоніальний
...
</noinclude>

Таким чином можно зазначити 40 варіантів (необхідно використовувати варіанти від var1 до var40). Якщо потрібно більше варіантів, їх можно зазначити у окремій підсторінці.

Зверніть увагу, що вам не потрібно використовувати параметр varN для стандартних варіантів міток ВМФ, ВПС та армія (які використовуються для прапорів військово-морських сил, військово-повітряних сил та армії). Якщо вони є, вони автоматично документуються.

Багато шаблонів даних країни мають аліаси які можно використовувати замість стандартних назв країн. Це зазвичай, але не обов'язково, стандартний код країни визначений у ISO 3166-1 або МОК, чи ФІФА. Вони використовуються як перенаправлення і перелічені у Категорія:Перенаправлення даних країн.

Наприклад, Шаблон:Дані країни DEU та Шаблон:Дані країни GER перенаправляють на Шаблон:Дані країни Німеччина, тому, що DEU це ISO код, а GER код МОК і ФІФА для Німеччини. Крім того, {{ПрапорЗначок|DEU}}, {{ПрапорЗначок|GER}} та {{ПрапорЗначок|Німеччина}} усі дають однаковий результат. Ці аліаси перенаправлення задокументовані у наступному фрагменті коду шаблона:

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

Таким чином можно зробити п'ять перенаправлень (використовуючи від redir1 до redir5).

Деякі шаблони даних країни використовують посилання на інші шаблони країни які відносяться до цієї країни, зазвичай, але не завжди, відносяться до історичних країн. Посилання на ці альтернативні шаблони є корисними додатками у документації тому редактори можуть правильно використовувати ці шаблони.

Наприклад, Шаблон:Дані країни Сербія і Чорногорія включає наступний код з посиланнями на три інших шаблони:

<noinclude>
...
| related1 = Сербія
| related2 = Чорногорія
| related3 = СР Югославія
...
</noinclude>

Таким чином можно вказати до шести посилань (від related1 до related6).

Цей параметр показує великий прапор у правій частині сторінки документації шаблону, з посилання на статтю про прапор у назві, якщо така існує. Сторінка має назву "Прапор {{{alias}}}", де параметр |alias= бере назву країни з параметру шаблону {{{alias}}} (через використання відмінників в українській мові цей параметр не спрацьовує). Для створення посилання на статтю про прапор в українській Вікі краще використовувати параметр:

<noinclude>
...
| flag link = ''Назва статті''
...
</noinclude>

Якщо для опису шаблону не достатньо стандартної документації, можно створити підсторінку документації для зазначення додаткових даних (вона має назву Шаблон:Дані країни Назва країни/документація), ці дані будуть відображатися у нижній частині сторінки документації. Приклад:

• Шаблон:Дані країни Ірландія/документація використовується для пояснення, чому цей шаблон відрізняється від Шаблон:Дані країни Ірландська республіка
• Шаблон:Дані країни Франція/документація використовується для переліку всіх регіонів Франції
• Шаблон:Дані країни Сполучені Штати/документація використовується для визначення повного переліку варіантів прапорів, а також для визначення всіх шаблонів штатів і підконтрольних територій

Цей шаблон автоматично категоризує сторінки які відносяться до Категорія:Всі шаблони даних країн. Категорії контенту, наприклад за країною або за типом об'єкту/статусом, необхідно додавати вручну розміщуючи між тегами <includeonly>...</includeonly> на підсторінці документації. Якщо шаблон ще немає підсторінки, натисніть посилання "/документація" у нижній частині автоматичної документації, додайте категорії між тегами <includeonly> і сбережіть сторінку.

Для сортування Шаблон:Дані країни використовується стандартні методи. Параметр |cat= можно використовувати для визначення специфічного ASCII ключа сортування для цих категорій. Наприклад, Шаблон:Дані країни Аландські острови та Шаблон:Дані країни Ірландська республіка використовують цей параметр для сортування їх за літерами "A" та "I" відповідно.