Користувач:Anaty/тест/Проект шаблони/Прапорові шаблони
Створює невелике зображення вказаного прапора.
Створює невелике зображення вказаного прапора, а також вікі-посилання на відповідну статтю.
- Наприклад:
{{Прапор з назвою|Україна}}
→ Шаблон:Прапор з назвою
![]() | Зауважимо, що вікі-код: {{Прапор|назва}} [[назва]] можна (і треба) замінити більш простим: {{Прапор з назвою|назва}} . |
Багато країн також мають індивідуальний прапорний шаблон, назва якого являє собою стандартний трилітерний код країни, що дає змогу використовувати «скорочені» альтернативи для стандартних шаблонів. В цьому є як свої плюси, так і мінуси; деякі коди країн (такі як «USA») добре відомі і відповідний скорочений шаблон (тобто {{USA}}
) є зручним, однак коди інших країн є відносно маловідомими і неочевидними, а отже вікі-розмітка, ймовірно, буде зрозумілішою, якщо використовуватимуться повні назви країн. Крім того скорочені шаблони не забезпечують можливості використання варіантів прапора (див. нижче), а отже є менш гнучкими.
- Наприклад:
{{AFG}}
→Афганістан (еквівалентно
{{Прапор з назвою|Афганістан}}
)
Див. Wikipedia:Inline templates linking country articles для одержання повного списку.
Перший (позиційно) параметр обох шаблонів являє собою назву країни (або іншого утворення), і визначає зображення прапора. Насправді в цьому випадку генеруються додаткові індивідуальні шаблони, які зберігають інформацію специфічну для цієї країни. Наприклад, ім’я зображення та назва основної статті, що використовуються в {{Прапор з назвою|Куба}}
(для виводу Шаблон:Прапор з назвою) зберігаються в Шаблон:Прапор/Куба. Повний набір шаблонів виду «Прапор/назва» можна знайти на сторінці Категорія:Прапорні шаблони.
Зверніть увагу, що шаблони «Прапор/назва» існують для багатьох утворень, які не є країнами, таких як міжнародні організації або внутрішньодержавні утворення.
Деякі приклади шаблону прапора для не країн:
{{Прапор з назвою|ООН}}
→ Шаблон:Прапор з назвою{{Прапор з назвою|ЄС}}
→ Шаблон:Прапор з назвою{{Прапор з назвою|Техас}}
→ Шаблон:Прапор з назвою{{Прапор з назвою|Баварія}}
→ Шаблон:Прапор з назвою
Також існує багато шаблонів «Прапор/назва» для історичних держав, і вони можуть бути використані для одержання історичних прапорів разом з вікі-посиланнями на відповідні статті. Ось деякі приклади:
{{Прапор з назвою|Австро-Угорщина}}
→ Шаблон:Прапор з назвою{{Прапор з назвою|Qing Dynasty}}
→ Шаблон:Прапор з назвою{{Прапор з назвою|Nazi Germany}}
→ Шаблон:Прапор з назвою
Для більшого комфорту, більшість прапорів можуть бути продубльовані псевдонімом, як правило трилітерним кодом країни. Наприклад, замість {{Прапор|Великобританія}}
, ви можете просто використовувати {{Прапор|GBR}}
щоб отримати .
В переліках ISO 3166-1 alpha-3, МОК, та FIFA наведені псевдоніми практично для кожної країни. Наприклад, {{Прапор|DEU}}
(ISO) і {{Прапор|GER}}
(МОК та FIFA) обидва утворюють . Також доступна невелика кількість інших добре відомих скорочень (таких як
UK
, EU
, та СРСР
).
Псевдоніми реалізовані як переспрямовування в просторі імен шаблонів. Наприклад, Шаблон:Прапор/FRA є переспрямовуванням на Шаблон:Прапор/Франція. Повний набір цих переспрямовувань наведений на сторінці Категорія:Прапорні перенаправлення, а в документації по шаблону конкретної країни також вказані всі доступні для неї (якщо такі є) псевдоніми для переспрямовування.
При використанні як псевдоніму коду країни, шаблон Прапор з назвою
буде відображати в тексті вікі-посилання повну назву, а не текст параметру. Наприклад:
{{Прапор з назвою|USA}}
→ Шаблон:Прапор з назвою{{Прапор з назвою|UK}}
→ Шаблон:Прапор з назвою{{Прапор з назвою|CHN}}
→ Шаблон:Прапор з назвою
Однак якщо в якості тексту вікі-посилання все ж таки необхідно відобразити код країни (або інший текст) слід використовувати параметр текст
, описаний нижче.
Багато країн в різні періоди своєї історії мали різні варіанти прапора. Система прапорних шаблонів враховує таку ситуацію і зберігає всередині шаблону «Прапор/назва» різні варіанти прапора. За допомогою додаткового параметра до будь-якого зі стандартних прапорних шаблонів вибирається конкретний варіант прапора. Такий параметр зазвичай передається у шаблон як другий позиційний параметр, однак він також може бути представлений у вигляді іменованого параметра варіант
.
- Приклади
{{Прапор з назвою|Німеччина|імперія}}
→ Шаблон:Прапор з назвою{{Прапор з назвою|Німеччина|варіант=імперія}}
→ Шаблон:Прапор з назвою{{Прапор з назвою|CAN|1921}}
→ Шаблон:Прапор з назвою{{Прапор|CAN|1921}}
→
Доступні варіанти прапора (якщо такі є) для конкретного шаблону «Прапор/назва» наведені на сторінці документації по даному шаблону. Кожний варіант визначається короткою текстовою міткою подібною до міток імперія
або 1921
, як у поданих вище прикладах. Як правило, мітка визначає рік коли було запроваджено прапор, однак це не обов’язково.
Для всіх прапорів, що створюються за допомогою цих шаблонів по замовчуванню встановлено розмір 22x20 пікселів, включаючи один піксел на рамку. Тобто ширина зображення не буде більшою ніж 22 піксела, а висота не буде більше ніж 20 пікселів. Більшість прапорів мають горизонтальну орієнтацію, тому обмежувальним розміром буде 22 піксела по ширині. Такі розміри ретельно підбирались щоб отримати найкращий результат при використанні зображень прапорів у маркованих списках при стандартному розмірі тексту.
В деяких ситуаціях доцільніше використовувати більший (або менший) розмір, і таку можливість надає іменований параметр розмір
, який доступний у всіх стандартних шаблонах.
- Приклади
{{Прапор|Бразилія|розмір=40px}}
→<small>{{Прапор з назвою|Італія|розмір=15px}}</small>
→ Шаблон:Прапор з назвою
Текст що відображується для вікі-посилання зазвичай генерується автоматично, однак він може бути примусово перевизначений за допомогою параметра текст
.
- Приклади
{{Прапор з назвою|South Korea|текст=Korea}}
→ Шаблон:Прапор з назвою (така назва використовується в деяких видах спорту){{Прапор з назвою|ROC|текст=China}}
→ Шаблон:Прапор з назвою (Китай з 1912 по 1949 роки)
Подібний до flagcountry
, однак змінює вікі-посилання додаючи до назви країни вказаний суфікс. Це корисно коли з основної теми виділяється серія статей в розрізі країн.
- Приклади
{{flaglink|SRB|in the Eurovision Song Contest 2007}}
→Сербія
{{flaglink|AUS|at the 2002 Commonwealth Games}}
→Австралія
Відображає військово-морський прапор вказаної країни (ідентичний варіанту морський
у відповідному шаблоні «Прапор/назва») а також вікі-посилання на основну статтю по військово-морському флоту країни.
- Приклад:
{{Флот|UKR}}
→Військово-морські сили України
Відображає військово-повітряний прапор вказаної країни (ідентичний варіанту повітряний
у відповідному шаблоні «Прапор/назва») а також вікі-посилання на основну статтю по військово-повітряному флоту країни.
- Приклад:
{{ВПС|Польща}}
→Повітряні сили Польщі
Одним з найпоширеніших випадків використання у Вікіпедії зображення прапора є посилання на національну спортивну команду. Деякі групи шаблонів в основу яких закладено вид спорту також були розроблені з використанням системи прапорових шаблонів:
- Template:bd для badminton
- Template:bk для basketball
- Template:cr для cricket
- Template:fb для football (soccer)
- Template:fh для field hockey
- Template:hb для team handball
- Template:ih для ice hockey
- Template:nb для netball
- Template:rl для rugby league
- Template:ru для rugby union
- Template:ru7 для rugby sevens
- Template:vb для volleyball
- Template:davis та Template:fed для tennis (Davis Cup та Fed Cup)
- Template:bandy для bandy
- Template:korf для korfball
- Template:speedway для motorcycle speedway
Таким шаблонам спеціально присвоєні короткі імена, оскільки вони, як правило, дуже часто використовуються на окремих сторінках з описом результатів матчів. Вони повністю замінюють попередній набір шаблонів, основою яким слугували національні команди. Наприклад, {{fb|ITA}}
замінює {{ITAf}}
, {{ru|NZL}}
замінює {{NZLru}}
, тощо.
Для певного виду спорту доступні кілька варіантів шаблону:
- з суфіксом "w", формує посилання на жіночу спортивну команду
- з суфіксом "-rt", розміщує зображення прапора праворуч від імені нації а не ліворуч. Такий стиль форматування часто використовують для опису результатів спортивних матчів
- з суфіксом -big", формує зображення прапору у збільшеному розмірі, а назву нації під цим прапором. Такий стиль форматування часто використовують в описі турнірних таблиць.
Наприклад, для футболу використовуються такі шаблони:
Команда | Прапор ліворуч | Прапор праворуч | Великий прапор |
---|---|---|---|
Чоловічі національні команди | {{fb}} | {{fb-rt}} | {{fb-big}} |
Examples | ![]() |
[[Збірна Шаблон:Назва країни РВ France з футболу|Франція]] ![]() |
![]() Італія |
Жіночі національні команди | {{fbw}} | {{fbw-rt}} | {{fbw-big}} |
Examples | ![]() |
[[Жіноча збірна Шаблон:Назва країни РВ Brazil з футболу|Бразилія]] ![]() |
![]() [[Жіноча збірна Шаблон:Назва країни РВ Germany з футболу|Німеччина]] |
Користувачі, яким не подобається наявність прапорів можуть відключити їх відображення виконавши необхідні налаштування. В середині шаблону для форматування використовуються CSS класи, а параметри класів можуть бути змінені користувачем у власному фалі monobook.css.
Відображення прапорів можна відключити додавши у цей файл такий рядок:
.flagicon { display: none; }
Системою прапорових шаблонів використовується три типи шаблонів, кожен з яких виконує свою функцію:
- Користувацькі шаблони
- Шаблони country data templates (внутрішній)
- Шаблони форматування (внутрішній)
Наприклад, {{flag|Spain}}
, використовує:
- Template:Flag, для прийому вхідних параметрів, таких як назва країни (обов’язковий) і необов’язкових, які визначають варіант прапора, розмір та відображуваний текст вікі-посилання.
- Template:Country data Spain, щоб одержати ім’я зображення та назву статті.
- Template:Country flag2, щоб фактично візуалізувати зображення та вікі-посилання.
Така архітектура системи означає, що:
- всі дані по конкретним країнам містяться в окремих шаблонах country data, що підвищує зручність експлуатації;
- форматування вікі-коду зосереджене в невеликій кількості шаблонів, що забезпечує узгодженість системи.
Робота кожного прапорового шаблону відбувається у три етапи.
У попередньому прикладі {{flag|Spain}}
, шаблон розгортався наступним чином:
По-перше, Template:Flag
розгортається викликаючи Template:Country data Spain
, і перевіряє чи задані всі параметри, що мають бути встановлені користувачем. Першим параметром для шаблону country data є насправді ім’я шаблону форматування. Це є тим механізмом, за допомогою якого той же шаблон country data може бути використаний кількома різними шаблонами форматування. Таким чином перший етап розгортання призводить до:
{{country data Spain | country flag2 | variant = | size = | name = Spain}}
Якщо параметри прапорового шаблону variant
(або другий за порядком параметр), size
, та/або name
були визначені користувачем, вони будуть встановлені у відповідні значення. Наприклад, {{flag|Spain|1939|name=Espana}}
буде розгорнуто до виду:
{{country data Spain | country flag2 | variant = 1939 | size = | name = España}}
Далі, шаблон country data розгортається для активізації шаблону форматування, а також додає всі необхідні параметри. Повертаючись до простого прикладу {{flag|Spain}}
, результат другого розширення матиме вигляд:
{{country flag2 | alias = Spain | flag alias = Flag of Spain.svg | name = Spain}}
Насамкінець, шаблон форматування розгортається до кінцевого вигляду:
<span class="flagicon">[[File:Flag of Spain.svg|22x20px|border |alt=|link=]] </span>[[Spain]]
Структура всіх шаблонів country data слідує стандартному зразку, який розширений, щоб включити додаткові параметри тільки, коли необхідний. The structure of all country data templates follows a standard pattern, which is extended to include additional parameters only when necessary. Порожній The empty boilerplate for all country data templates is as follows:
{{ {{{1<noinclude>|country showdata</noinclude>}}} | alias = | flag alias = | size = {{{size|}}} | name = {{{name|}}} }}
Є два обов’язкових значення, які повинні бути зазначені:
- Значення
alias
, яке визначає назву головної статті, пов’язаної з прапором. - Значення
flag alias
яке визначає ім’я зображення прапора, що є основним для країни.
Виклик country showdata
в першому рядку використовується для автоматичного створення шаблону документації, як описано нижче.
The size = {{{size|}}}
and name = {{{name|}}}
statements ensure that any user-specified size and/or name values are passed through from the outer template (flag
, flagicon
, etc.) to the inner formatting template. Omission of these lines from the country data template would cause the size and name functionality to be disabled.
Additional flag variants are specified by individual flag alias
statements. The unique label for the variant is the suffix of the parameter name, as flag alias-label
(don't forget the hyphen). For example, Template:Country data Mexico has several flag variants, one of which is specified by:
| flag alias-1934 = Flag of Mexico (1934-1968).png
Therefore, when {{flag|Mexico|1934}}
is transcluded, Image:Flag of Mexico (1934-1968).png is rendered. The selection of the flag variant is coded in the formatting templates.
Country data templates with at least one flag variant (in addition to the default) must also have the following line:
| variant = {{{variant|}}}
Similar to the size
and name
parameters as described above, this statement is required to pass the variant value (e.g. 1934
) from the outer flag template to the inner formatting template. Omission of this line will cause the flag variant selection to fail.
The best results are obtained when the template name matches the article wikilink (as specified by the alias
value). For example, Template:Country data Russia contains alias = Russia
, which results in a target wikilink to Russia.
However, there are instances where the main article name contains a disambiguation string. For example, Template:Country data Georgia contains alias = Georgia (country)
. Therefore, {{flag|Georgia}}
results in . Note that the wikilink is Georgia (country), but the display string is "Georgia", as expected.
In these instances, an additional statement is needed to support Template:Flagcountry properly. The shortname alias
parameter should be set to the desired text string, such as shortname alias = Georgia
. In effect, the resultant wikilink will be generated as [[alias|shortname alias]]
, or [[Georgia (country)|Georgia]]
in this specific example.
Any country data template that will be used with a national team template must include an additional "pass-through" parameter:
| altlink = {{{altlink|}}}
This parameter is used to form the suffix of the associated wikilink. For example, Template:cr appends "national cricket team" to the country name (alias
value), and this process is enabled by the altlink
parameter.
In most cases, the flag and display name for national teams corresponds to the same flag and display name normally used for the nation. However, in some instances these can be over-ridden by additional parameters within the country data template. The default wikilink can also be changed in cases where the common naming convention is not used.
Ось деякі приклади:
- У FIFA South Korea називається "Korea Republic". Таким чином, Template:Country data South Korea включає
name alias-football
so that{{fb|South Korea}}
produces[[Збірна Шаблон:Назва країни РВ South Korea з футболу|Південна Корея]]
- In many sports, all-Ireland teams compete with athletes from both the Republic of Ireland and Northern Ireland, and often under unique flags for each sport. Template:Country data Ireland includes unique flags for several sports teams, such as
flag alias-field hockey = Flag of Ireland hockey team.svg
, so that{{fh|Ireland}}
produces[[Збірна Шаблон:Назва країни РВ Ireland з хокею на траві|Ірландія]]
- The New Zealand netball team is described at the Silver Ferns article, so to avoid the redirect at New Zealand national netball team, Template:Country data New Zealand contains
link alias-netball = Silver Ferns
so that{{nb|New Zealand}}
producesНова Зеландія
In each of these examples, the over-ride parameter (name alias-football
, flag alias-field hockey
, or link alias-netball
) is identified by a unique per-sport variable that is passed from the appropriate sport team template. For example, Template:fb includes altvar = football
. Therefore, any country data template that utilizes one or more team sport over-ride parameters must also include:
| altvar = {{{altvar|}}}
Шаблони country data «самостійно» документують себе через Template:Country showdata. Нагадаємо, що перший рядок кожного шаблону country data є викликом шаблону форматування, defaulting to country showdata
if that parameter is missing:
Для документування простих шаблонів country data, нічого додаткового робити не потрібно. Якщо з шаблоном використовуються варіанти прапорів, псевдоніми для переспрямовування, та ін. вони документуються додаванням спеціальних параметрів що використовуються в country showdata
. Такі параметри вкладуються в секцію <noinclude>....</noinclude>
, оскільки вони не повинні бути присутніми в будь-якому іншому виклику шаблону country data.
Див. Template:Country showdata/doc для одержання більш детальної інформації щодо того як документувати шаблони country data.
- {{flagIOC}} for a similar template used exclusively for Olympic Games related articles, and uses a different internal mechanism than for these templates.
- {{Shipboxflag}} for display of flags in ship infoboxes
- {{WikiProject Flag Template}} – banner for talk pages of template and flag-related project pages
- /Archive1 – Archive of project when testing of flag template was completed. June 23, 2005
- Revision as of 8 January 2007 – description of the previous version of the flag template system
- Revision as of 3 November 2007 – before this page was completely rewritten