stringtranslate.com

Википедия:Шаблон флага WikiProject

Этот WikiProject отвечает за систему шаблонов, используемых для создания иконок флагов, с соответствующими викиссылками или без них. Этот проект занимается только реализацией этих шаблонов.

Основные шаблоны

Шаблон:Значок флага

Создает небольшое изображение названного флага. Изображение имеет ссылку на статью о стране, связанной с флагом.

Пример: {{flag icon|Japan}} →Япония
Пример: {{flag icon|JPN}} →Япония

Шаблон:Флаг

Создает небольшое изображение названного флага, а также викиссылку на связанную статью. Изображение значка не имеет ссылки (в отличие от flag icon), чтобы экранные ридеры не отображали имя дважды.

Пример: {{flag|United Kingdom}} → Соединенное Королевство 

Шаблон:Flagu

Аналогично flag, но связанное название страны не связано. Этот шаблон следует использовать в статьях с проблемами WP:OVERLINK (например, когда один и тот же флаг используется много раз в одной таблице).

Пример: {{flagu|United States}} →  США

Шаблон:Флаг страны

Аналогично flag, но всегда использует предпочтительный текст отображения для викисвязанной статьи. Полезно, когда входной параметр может быть кодом страны или является полным названием страны, поскольку он ссылается на другую статью, например, на историческую страну.

Сравните с flag, который всегда использует первый параметр в качестве отображаемого имени (если только он не переопределен с помощью name):

Шаблон:Украшение флага

Отображает флаг указанного параметра в размере "значка", в настоящее время 23×15 пикселей плюс граница в один пиксель. Этот шаблон очень похож на Template:Flag icon , за исключением того, что изображение не связано со статьей, т. е. является "чисто декоративным" согласно Руководству по доступности веб-контента (WCAG) Консорциума Всемирной паутины (W3C ). Этот шаблон можно использовать, когда текст статьи, непосредственно примыкающий к значку, предоставляет связанную ссылку для флага.

Пример сравнения
Примеры использования

Шаблоны флагов «Ярлык»

Во многих странах также есть индивидуальные шаблоны флагов, названные с использованием стандартных трехбуквенных кодов стран, чтобы предлагать «сокращенные» альтернативы стандартным шаблонам. Это неоднозначное благословение; некоторые коды стран (например, «США») широко известны, и соответствующие шаблоны сокращений (например, {{USA}}) удобны, но некоторые коды стран относительно малоизвестны, поэтому разметка вики, вероятно, будет понятнее, если названия стран будут указаны полностью. Кроме того, шаблоны сокращений не предлагают возможности использовать исторические варианты флагов (описанные ниже), и поэтому менее гибки.

Пример: {{BEL}} → Бельгия (эквивалентно )  {{flag|Belgium}}

Полный список см . в Википедии: Встроенные шаблоны, связывающие статьи о странах .

Список

Помимо упомянутых выше, существует множество других шаблонов флагов. Этот (вероятно, неполный) список не включает военные (см. #Шаблоны военных флагов) и спортивные шаблоны (см. #Шаблоны флагов национальных спортивных команд). Более подробную информацию см. в документации к каждому шаблону.

Следующие шаблоны технически не используют систему шаблонов флагов, но используются аналогичным образом:

Названия флагов

Первый (позиционный) параметр для этих шаблонов указывает страну (или другую сущность), которая будет использоваться для изображения флага. Фактически они идентифицируют дополнительные шаблоны, которые индивидуально хранят информацию, специфичную для этой страны. Например, имя изображения и имя основной статьи, используемые {{flag|Norway}}(для создания Норвегии ), хранятся в Шаблон:Данные о стране Норвегия . Полный набор этих шаблонов "данных о стране" находится в Категория:Шаблоны данных о стране . 

Обратите внимание, что существуют шаблоны данных стран для многих сущностей, которые не считаются странами , например, международные организации или субнациональные сущности. Использование слова «страна» в этих названиях шаблонов связано только с тем, что первоначальная реализация системы шаблонов флагов была построена на Template:Country – лучшим названием могло бы быть «данные флагов», но сейчас, вероятно, уже слишком поздно для таких изменений.

Вот несколько примеров шаблонов флагов, не относящихся к странам:


Многие шаблоны данных стран также существуют для исторических наций, и их можно использовать для создания исторических флагов с вики-ссылками на соответствующие статьи. Вот несколько примеров:

Псевдонимы

Для большего удобства многие флаги можно идентифицировать по псевдониму , обычно трехбуквенному коду страны. Например, вместо {{flag icon|France}}, вы можете просто использовать {{flag icon|FRA}}для созданияФранция.

Псевдонимы доступны почти для каждой страны, перечисленной в ISO 3166-1 alpha-3 , списке кодов стран МОК и списке кодов стран ФИФА . Например, {{flag icon|DEU}}(ISO) и {{flag icon|GER}}(МОК и ФИФА) оба производятГермания. Также доступно небольшое количество других известных сокращений (например UK, EU, и USSR).

Имена псевдонимов реализованы как перенаправления в пространстве имен шаблонов. Например, Template:Country data VEN — это перенаправление на Template:Country data Venezuela . Полный набор этих перенаправлений перечислен в Category:Country data redirects , а доступные перенаправления псевдонимов для заданного шаблона данных о стране (если таковые имеются) также документированы на странице этого шаблона.

При использовании псевдонимов кода страны шаблон flagбудет отображать это значение для отображаемого текста викиссылки. Например:

Обратите внимание, что в каждом случае целевая викиссылка указывает на правильное название статьи (то есть United States , United Kingdom и People's Republic of China , соответственно), но отображаемый текст соответствует входному параметру template flag. Это может быть желаемым эффектом, например, в заголовках столбцов большой таблицы, но если требуется полное название, то используйте Template:Flag country вместо этого:

Имена псевдонимов имеют вторую цель, которая заключается в предоставлении альтернативного отображаемого текста для целевых вики-ссылок. Например, основная статья, связанная с Template:Country data East Germany , — это East Germany , но Template:Country data German Democratic Republic — это псевдоним перенаправления. Поэтому вы можете использовать {{flag|German Democratic Republic}}для German Democratic Republic . Опять же, обратите внимание, что целевое имя статьи для сгенерированной вики-ссылки по-прежнему East Germany . 

Варианты флага

Во многих странах в разные периоды истории были разные варианты флагов. Система шаблонов флагов может это учесть, сохраняя несколько вариантов флагов внутри шаблонов данных стран. Конкретный вариант флага выбирается путем указания дополнительного параметра для любого из стандартных шаблонов флагов. Этот параметр обычно указывается как второй позиционный параметр шаблона, но может также указываться как variantименованный параметр.

Примеры

Набор доступных вариантов флага (если таковые имеются) для конкретного шаблона данных страны документируется на самой странице шаблона данных страны. Каждый вариант идентифицируется короткой текстовой меткой, например, empireили 1921в примерах выше. Обычно метка идентифицирует год, в котором был представлен флаг, но это не обязательное соглашение о стиле.

Другие общие параметры

Размер

Размер по умолчанию для всех значков флагов, созданных этими шаблонами, составляет 23x15 пикселей с границей в один пиксель. То есть, значок будет не более 23 пикселей в ширину и не более 15 пикселей в высоту. Эти размеры были тщательно подобраны для получения наилучших результатов при использовании значков флагов в маркированном списке с размером текста браузера по умолчанию. Некоторые страны (в основном те, у которых квадратные или почти квадратные флаги) имеют другие размеры по умолчанию.

В определенных ситуациях может потребоваться использовать больший (или меньший) размер, и это включается с помощью sizeименованного параметра, доступного во всех стандартных шаблонах.

Примеры

Имя

Отображаемый текст целевой вики-ссылки обычно генерируется автоматически, но его всегда можно переопределить с помощью nameпараметра.

Примеры


Шаблоны военных флагов

Шаблон:Военно-морской флот

Отображает военно-морской флаг указанной страны (указанный как navalвариант в соответствующем шаблоне данных страны) плюс викиссылку на основную статью о флоте страны. Обратите внимание, что военно-морской флаг для многих стран совпадает с национальным флагом. Также обратите внимание, что соглашения WP:SHIPS и WP:MILHIST предусматривают использование военно-морских флагов, а не военно-морских гюйсов при идентификации судов с помощью значков флагов.

Примеры

Шаблон:Военно-морской

Отображает флаг ВМС указанной страны (указанный как navyвариант в соответствующем шаблоне данных страны) плюс викиссылку на основную статью о ВМС страны. Обратите внимание, что это флаг ВМС, который отличается от военно-морского флага, который для многих стран совпадает с национальным флагом. Если у ВМС нет флага, вместо него используется гюйс. Также обратите внимание, что соглашения WP :SHIPS и WP:MILHIST предусматривают использование военно-морских флагов, а не военно-морских флагов при идентификации кораблей с помощью значков флагов.

Примеры

Шаблон:Береговая охрана

Отображает флаг береговой охраны страны ( coast guardвариант) или, в качестве альтернативы, ее гоночную полосу , а также вики-ссылку на береговую охрану страны.

Примеры

Шаблон:Армия

Отображает армейский или военный флаг страны ( armyвариант) и вики-ссылку на армию страны.

Примеры

Шаблон:Военно-воздушные силы

Отображает флаг военно-воздушных сил страны ( air forceвариант) и вики-ссылку на военно-воздушные силы страны.

Примеры

Шаблоны флагов национальных спортивных команд

Один из наиболее распространенных случаев использования значка флага в Википедии — национальные спортивные команды. Было разработано несколько наборов шаблонов для конкретных видов спорта, чтобы также использовать эту систему шаблонов флагов, и некоторые из них имеют вариантные формы (см. документацию по отдельным шаблонам):

Эти шаблоны намеренно получили краткие названия, поскольку они, как правило, используются много-много раз на отдельных страницах для результатов матчей. Они полностью заменяют набор ранее использовавшихся шаблонов, специфичных для национальных сборных. Например, {{fb|ITA}}replacement {{ITAf}}, {{ru|NZL}}replacement {{NZLru}}{{cr|BGD}}replacement {{BCB}}и т. д.

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

Например, для футбола используются следующие шаблоны:

Пользовательская настройка отключения отображения значков флагов

Пользователи, которым не нравятся значки флагов, могут отключить их с помощью настройки предпочтений. Класс CSS используется в шаблоне внутреннего форматирования, а настройки класса можно изменить из персонального файла CSS пользователя ( специфичного для скина , кросс-скин или глобального).

Отображение изображения значка флага отключено:

.flagicon { дисплей: нет; }

Выполнение

Система шаблонов флагов использует три типа шаблонов, каждый из которых имеет свою функцию:

  1. Шаблоны, включенные пользователем
  2. Шаблоны данных по странам (внутренние)
  3. Шаблоны форматирования (внутренние)

Например, {{flag|Spain}}, использует:

  1. Шаблон:Флаг , для приема входных параметров, таких как название страны (обязательно) и необязательный вариант флага, размер и отображаемое имя вики-ссылки.
  2. Шаблон:Данные по стране Испания , для указания имени изображения и названия статьи
  3. Шаблон:Flag/core , для фактического отображения значка изображения и вики-ссылки

Такая архитектура системы означает, что:

Как это работает

В каждом вызове шаблона флага есть три шага. В предыдущем примере {{flag|Spain}}шаблоны расширяются следующим образом:

Сначала Template:Flagрасширяется для вызова Template:Country data Spainи обеспечивает установку всех указанных пользователем параметров. Первый параметр шаблона данных страны на самом деле является именем шаблона форматирования . Это механизм, с помощью которого один и тот же шаблон данных страны может использоваться с несколькими различными шаблонами форматирования. Таким образом, первый шаг расширения приводит к:

{{данные о стране Испания | флаг/ядро | вариант = | размер = | название = Испания}}

Если variant(или второй позиционный параметр), параметры size, и/или nameбыли указаны в вызове пользователя, они будут установлены в желаемое значение. Например, {{flag|Spain|1939|name=España}}будет расширен до:

{{данные о стране Испания | флаг/основа | вариант = 1939 | размер = | название = España}}

Далее шаблон данных страны расширяется для вызова шаблона форматирования, а также добавляет все параметры, специфичные для страны. Возвращаясь к более простому примеру {{flag|Spain}}, второе расширение приводит к:

{{flag/core | псевдоним = Испания | псевдоним флага = Флаг Испании.svg | имя = Испания}}

Наконец, шаблон форматирования расширяется и получается:

<span class="flagicon">[[Файл:Флаг Испании.svg|23x15px|border |alt=|link=]] </span>[[Испания]]

Базовая структура шаблона данных страны

Структура всех шаблонов данных стран соответствует стандартному шаблону, который расширяется для включения дополнительных параметров только при необходимости. Пустой шаблон для всех шаблонов данных стран выглядит следующим образом:

{{ {{{1<noinclude>|показать данные о стране</noinclude>}}}| псевдоним =| псевдоним флага =| размер = {{{размер|}}}| имя = {{{имя|}}}}}

Необходимо указать два основных значения:

  1. Значение aliasопределяет название основной статьи, связанной с флагом.
  2. Значение flag aliasопределяет имя изображения флага по умолчанию.

Вызов country showdataв первой строке используется для автоматического создания документации шаблона, как описано ниже. Операторы size = {{{size|}}}и name = {{{name|}}}гарантируют, что любые указанные пользователем значения размера и/или имени передаются из внешнего шаблона ( flag, flag icon, и т. д.) во внутренний шаблон форматирования. Пропуск этих строк в шаблоне данных о стране приведет к отключению функциональности размера и имени.

Добавление вариантов флага

Дополнительные варианты флагов указываются отдельными flag aliasоператорами. Уникальная метка для варианта — это суффикс имени параметра, как (не забудьте дефис). Например, Template:Country data Mexico имеет несколько вариантов флагов, один из которых указывается как:flag alias-label

| flag alias-1934 = Флаг Мексики (1934-1968).png

Поэтому, когда {{flag|Mexico|1934}}включено, отображается Image:Flag of Mexico (1934-1968).png . Выбор варианта флага закодирован в шаблонах форматирования.

Шаблоны данных по странам с хотя бы одним вариантом флага (в дополнение к варианту по умолчанию) также должны иметь следующую строку:

| вариант = {{{вариант|}}}

Подобно параметрам sizeи , nameописанным выше, этот оператор требуется для передачи значения варианта (например 1934) из внешнего шаблона флага во внутренний шаблон форматирования. Пропуск этой строки приведет к сбою выбора варианта флага.

Отключение рамки изображения

Если некоторые флаги имеют нестандартную форму и граница в 1 пиксель нежелательна (например, для Непала ), то границу для основного флага можно отменить, добавив параметр

|граница =

Чтобы удалить границу только для определенных флагов вариантов, используйте шаблон , заменив его соответствующей меткой варианта. Например:|border-variant=variant

|граница-1976 =|погранично-колониальный =

После знака(ов) равенства ничего не добавляется. Примеры использования см. в Шаблоне:Данные по странам Польша .

Из-за кодирования шаблонов флагов отключение границы для основного флага также автоматически отключает ее для всех вариантов флага. Если основной флаг не должен иметь границу, но какой-либо из вариантов должен, соответствующие параметры должны быть явно установлены на "border", чтобы снова включить границу в 1px:|border-variant=

|граница-1976 = граница

Изменение отображаемого текста вики-ссылки

Наилучшие результаты достигаются, когда имя шаблона совпадает со статьей wikilink (как указано в значении alias). Например, Template:Country data Russia contains alias = Russia, что приводит к целевой wikilink на Россию .

Однако есть случаи, когда основное название статьи содержит строку разрешения неоднозначности. Например, Template:Country data Georgia содержит alias = Georgia (country). Таким образом, {{flag|Georgia}}результаты в Georgia . Обратите внимание, что викиссылка — Georgia (country) , но отображаемая строка — "Georgia", как и ожидалось. 

В этих случаях для правильной поддержки Template:Flag country требуется дополнительный оператор . shortname aliasПараметр должен быть установлен на желаемую текстовую строку, например shortname alias = Georgia. По сути, результирующая викиссылка будет сгенерирована как , или в этом конкретном примере.[[alias|shortname alias]][[Georgia (country)|Georgia]]

Изменение страницы, на которую указывает ссылка

Шаблоны {{ flaglink }} и {{ flag+link }} добавляют и вставляют текст в начало и конец ссылки соответственно. Например, чтобы сослаться на систему образования в таблице, сравнивающей образовательные результаты разных стран, используйте

{{flag+link|Образование в|Финляндии}}

Что приводит к Финляндии . 

Для целевых ссылок, которые не начинаются или не заканчиваются названием страны, используйте шаблон {{ flagdeco }} (который возвращает несвязанный значок флага без текста), за которым следует стандартная вики-ссылка:

{{flagdeco|Финляндия}} [[Пример страницы|Финляндия]]

Которая будет выглядеть так: Финляндия.

Параметры шаблона национальной спортивной команды

Любой шаблон данных страны, который будет использоваться с шаблоном национальной команды, должен включать дополнительный «сквозной» параметр:

| альтернативная ссылка = {{{альтернативная ссылка|}}}

Этот параметр используется для формирования суффикса связанной викиссылки. Например, Template:cr добавляет "национальную команду по крикету" к названию страны ( aliasзначение), и этот процесс включается параметром altlink.

В большинстве случаев флаг и отображаемое имя для национальных команд соответствуют тому же флагу и отображаемому имени, которые обычно используются для страны. Однако в некоторых случаях они могут быть переопределены дополнительными параметрами в шаблоне данных страны. Ссылку wiki по умолчанию также можно изменить в случаях, когда не используется общее соглашение об именовании.

Вот несколько примеров:

В каждом из этих примеров параметр переопределения ( name alias-football, flag alias-field hockey, или link alias-netball) идентифицируется уникальной переменной для каждого вида спорта, которая передается из соответствующего шаблона спортивной команды. Например, Template:fb включает altvar = football. Таким образом, любой шаблон данных по стране, который использует один или несколько параметров переопределения командного вида спорта, должен также включать:

| альтвар = {{{альтвар|}}}

Шаблон документации

Шаблоны данных стран "самодокументируют" себя через Template:Country showdata . Напомним, что первая строка каждого шаблона данных стран — это вызов шаблона форматирования, который по умолчанию принимает значение, country showdataесли этот параметр отсутствует:

Для простых шаблонов данных о странах больше ничего не нужно делать, чтобы задокументировать их. Если какие-либо варианты флагов, псевдонимы перенаправления и т. д. используются с шаблоном, они документируются путем добавления параметров специально для использования country showdata. Эти дополнительные параметры заключены в <noinclude>....</noinclude>раздел, поскольку они не должны присутствовать для любого другого вызова шаблона данных о стране.
Дополнительную информацию о том, как документировать шаблоны данных по странам, см. в разделе Шаблон:Страна showdata/doc.
Альтернативы, позволяющие избежать ВикипедииРазмер включения после расширенияпредел
Страницы с большим количеством флаговых иконок могут приблизиться или превзойти ограничение Википедии на размер включений после расширения . В этих случаях рассмотрите возможность использования модулей или шаблонов-оберток модулей:[
Смотрите также
Внутренние шаблоны проектов
Архивы