Шаблон:Показ даних країни/документація
 |
Це підсторінка документації шаблону Показ даних країни. Вона містить інформацію про використання, категорії та інший вміст, що не є частиною оригінальної сторінки шаблону. |
Цей шаблон використовується для створення мета-шаблонів данні країни, які використовуються системою шаблонів прапорів.
Дивись Вікіпедія:ВікіПроєкт Шаблони Прапорів для отримання основної інформації та сторінку обговорення системи шаблонів прапорів.
Використання[ред. код]
Шаблон автоматично використовується при зазначенні стандартного синтаксиса даних шаблона:
{{ {{{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" відповідно.