Користувач:Anaty/тест/Проект шаблони/Прапорові шаблони

Матеріал з Вікіпедії — вільної енциклопедії.
Перейти до навігації Перейти до пошуку

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

Основні шаблони[ред. | ред. код]

Шаблон:Прапор[ред. | ред. код]

Створює невелике зображення вказаного прапора.

Наприклад: {{Прапор|Японія}} → Японія

Шаблон:Прапор з назвою[ред. | ред. код]

Створює невелике зображення вказаного прапора, а також вікі-посилання на відповідну статтю.

Наприклад: {{Прапор з назвою|Україна}} → Шаблон:Прапор з назвою
Зауважимо, що вікі-код: {{Прапор|назва}} [[назва]] можна (і треба) замінити більш простим: {{Прапор з назвою|назва}}.

«Скорочені» прапорні шаблони[ред. | ред. код]

Багато країн також мають індивідуальний прапорний шаблон, назва якого являє собою стандартний трилітерний код країни, що дає змогу використовувати «скорочені» альтернативи для стандартних шаблонів. В цьому є як свої плюси, так і мінуси; деякі коди країн (такі як «USA») добре відомі і відповідний скорочений шаблон (тобто {{USA}}) є зручним, однак коди інших країн є відносно маловідомими і неочевидними, а отже вікі-розмітка, ймовірно, буде зрозумілішою, якщо використовуватимуться повні назви країн. Крім того скорочені шаблони не забезпечують можливості використання варіантів прапора (див. нижче), а отже є менш гнучкими.

Наприклад: {{AFG}} → Афганістан Афганістан (еквівалентно {{Прапор з назвою|Афганістан}})

Див. Wikipedia:Inline templates linking country articles для одержання повного списку.

Назви прапорів[ред. | ред. код]

Перший (позиційно) параметр обох шаблонів являє собою назву країни (або іншого утворення), і визначає зображення прапора. Насправді в цьому випадку генеруються додаткові індивідуальні шаблони, які зберігають інформацію специфічну для цієї країни. Наприклад, ім’я зображення та назва основної статті, що використовуються в {{Прапор з назвою|Куба}} (для виводу Шаблон:Прапор з назвою) зберігаються в Шаблон:Прапор/Куба. Повний набір шаблонів виду «Прапор/назва» можна знайти на сторінці Категорія:Прапорні шаблони.

Зверніть увагу, що шаблони «Прапор/назва» існують для багатьох утворень, які не є країнами, таких як міжнародні організації або внутрішньодержавні утворення.

Деякі приклади шаблону прапора для не країн:

Також існує багато шаблонів «Прапор/назва» для історичних держав, і вони можуть бути використані для одержання історичних прапорів разом з вікі-посиланнями на відповідні статті. Ось деякі приклади:

Псевдоніми[ред. | ред. код]

Для більшого комфорту, більшість прапорів можуть бути продубльовані псевдонімом, як правило трилітерним кодом країни. Наприклад, замість {{Прапор|Великобританія}}, ви можете просто використовувати {{Прапор|GBR}} щоб отримати Велика Британія.

В переліках ISO 3166-1 alpha-3, МОК, та FIFA наведені псевдоніми практично для кожної країни. Наприклад, {{Прапор|DEU}} (ISO) і {{Прапор|GER}} (МОК та FIFA) обидва утворюють Німеччина. Також доступна невелика кількість інших добре відомих скорочень (таких як UK, EU, та СРСР).

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

Будь ласка, не створюйте псевдоніми для переспрямовування з нестандартними скороченнями, особливо для країн або регіонів, які не мають стандартних кодів. Вікі-код набагато легше читати, якщо використовується повне ім’я. Навіть деякі зі стандартних кодів країн не користуються широкою популярністю!

При використанні як псевдоніму коду країни, шаблон Прапор з назвою буде відображати в тексті вікі-посилання повну назву, а не текст параметру. Наприклад:

Однак якщо в якості тексту вікі-посилання все ж таки необхідно відобразити код країни (або інший текст) слід використовувати параметр текст, описаний нижче.

Варіанти прапорів[ред. | ред. код]

Багато країн в різні періоди своєї історії мали різні варіанти прапора. Система прапорних шаблонів враховує таку ситуацію і зберігає всередині шаблону «Прапор/назва» різні варіанти прапора. За допомогою додаткового параметра до будь-якого зі стандартних прапорних шаблонів вибирається конкретний варіант прапора. Такий параметр зазвичай передається у шаблон як другий позиційний параметр, однак він також може бути представлений у вигляді іменованого параметра варіант.

Приклади

Доступні варіанти прапора (якщо такі є) для конкретного шаблону «Прапор/назва» наведені на сторінці документації по даному шаблону. Кожний варіант визначається короткою текстовою міткою подібною до міток імперія або 1921, як у поданих вище прикладах. Як правило, мітка визначає рік коли було запроваджено прапор, однак це не обов’язково.

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

Інші загальні параметри[ред. | ред. код]

Розмір[ред. | ред. код]

Для всіх прапорів, що створюються за допомогою цих шаблонів по замовчуванню встановлено розмір 22x20 пікселів, включаючи один піксел на рамку. Тобто ширина зображення не буде більшою ніж 22 піксела, а висота не буде більше ніж 20 пікселів. Більшість прапорів мають горизонтальну орієнтацію, тому обмежувальним розміром буде 22 піксела по ширині. Такі розміри ретельно підбирались щоб отримати найкращий результат при використанні зображень прапорів у маркованих списках при стандартному розмірі тексту.

В деяких ситуаціях доцільніше використовувати більший (або менший) розмір, і таку можливість надає іменований параметр розмір, який доступний у всіх стандартних шаблонах.

Приклади

Текст[ред. | ред. код]

Текст що відображується для вікі-посилання зазвичай генерується автоматично, однак він може бути примусово перевизначений за допомогою параметра текст.

Приклади

Інші прапорні шаблони[ред. | ред. код]

Template:Flaglink[ред. | ред. код]

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

Приклади

Шаблон:Флот[ред. | ред. код]

Відображає військово-морський прапор вказаної країни (ідентичний варіанту морський у відповідному шаблоні «Прапор/назва») а також вікі-посилання на основну статтю по військово-морському флоту країни.

Приклад: {{Флот|UKR}} →  Військово-морські сили України

Шаблон:ВПС[ред. | ред. код]

Відображає військово-повітряний прапор вказаної країни (ідентичний варіанту повітряний у відповідному шаблоні «Прапор/назва») а також вікі-посилання на основну статтю по військово-повітряному флоту країни.

Приклад: {{ВПС|Польща}} →  Повітряні сили Польщі

Прапорні шаблони національних спортивних команд[ред. | ред. код]

Одним з найпоширеніших випадків використання у Вікіпедії зображення прапора є посилання на національну спортивну команду. Деякі групи шаблонів в основу яких закладено вид спорту також були розроблені з використанням системи прапорових шаблонів:

Таким шаблонам спеціально присвоєні короткі імена, оскільки вони, як правило, дуже часто використовуються на окремих сторінках з описом результатів матчів. Вони повністю замінюють попередній набір шаблонів, основою яким слугували національні команди. Наприклад, {{fb|ITA}} замінює {{ITAf}}, {{ru|NZL}} замінює {{NZLru}}, тощо.

Для певного виду спорту доступні кілька варіантів шаблону:

  • з суфіксом "w", формує посилання на жіночу спортивну команду
  • з суфіксом "-rt", розміщує зображення прапора праворуч від імені нації а не ліворуч. Такий стиль форматування часто використовують для опису результатів спортивних матчів
  • з суфіксом -big", формує зображення прапору у збільшеному розмірі, а назву нації під цим прапором. Такий стиль форматування часто використовують в описі турнірних таблиць.

Наприклад, для футболу використовуються такі шаблони:

Команда Прапор ліворуч Прапор праворуч Великий прапор
Чоловічі національні команди {{fb}} {{fb-rt}} {{fb-big}}
Examples Італія Італія [[Збірна Шаблон:Назва країни РВ France з футболу|Франція]] Франція Італія
Італія
Жіночі національні команди {{fbw}} {{fbw-rt}} {{fbw-big}}
Examples Німеччина [[Жіноча збірна Шаблон:Назва країни РВ Germany з футболу|Німеччина]] [[Жіноча збірна Шаблон:Назва країни РВ Brazil з футболу|Бразилія]] Бразилія Німеччина
[[Жіноча збірна Шаблон:Назва країни РВ Germany з футболу|Німеччина]]

Можливість відключення відображення прапорів[ред. | ред. код]

Користувачі, яким не подобається наявність прапорів можуть відключити їх відображення виконавши необхідні налаштування. В середині шаблону для форматування використовуються CSS класи, а параметри класів можуть бути змінені користувачем у власному фалі monobook.css.

Відображення прапорів можна відключити додавши у цей файл такий рядок: 

.flagicon { display: none; }

Реалізація[ред. | ред. код]

Системою прапорових шаблонів використовується три типи шаблонів, кожен з яких виконує свою функцію:

  1. Користувацькі шаблони
  2. Шаблони country data templates (внутрішній)
  3. Шаблони форматування (внутрішній)

Наприклад, {{flag|Spain}}, використовує:

  1. Template:Flag, для прийому вхідних параметрів, таких як назва країни (обов’язковий) і необов’язкових, які визначають варіант прапора, розмір та відображуваний текст вікі-посилання.
  2. Template:Country data Spain, щоб одержати ім’я зображення та назву статті.
  3. 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=]]&nbsp;</span>[[Spain]]

Основи структури шаблону country data[ред. | ред. код]

Структура всіх шаблонів 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|}}}
}}

Є два обов’язкових значення, які повинні бути зазначені:

  1. Значення alias, яке визначає назву головної статті, пов’язаної з прапором.
  2. Значення 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.

Adding flag variants[ред. | ред. код]

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.

Changing the wikilink display text[ред. | ред. код]

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.

National sport team template parameters[ред. | ред. код]

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.

Ось деякі приклади:

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


Internal project templates[ред. | ред. код]



Archives[ред. | ред. код]









Отримано з https://uk.wikipedia.org/w/index.php?title=Користувач:Anaty/тест/Проект_шаблони/Прапорові_шаблони&oldid=38879043