Шаблон:Поиск страны

Материал из Википедии — свободной энциклопедии
Перейти к навигации Перейти к поиску
Документация

Шаблон извлекает из строки название страны в каком-угодно падеже и возвращает название в любом падеже, по умолчанию в именительном. Возвращает ничего, если нет совпадений.

Обратите внимание, что страна в строке должна быть правильно написана с большой буквы. «Индия» будет найдена, но «индия» или «ИНДИЯ» будут проигнорированы.

Список стран жестко закодирован в списке в Модуль:Find country/countries.json, основанном на списке государств, официальные и общеизвестные написания распознаются полностью, аббревиатуры и варианты написания распознаются выборочно, также находятся владения, некоторые субнациональные, владения, некоторые исторические страны. Код находит страны из следующих групп: Официальные названия стран → Аббревиатуры стран → Алиасы стран → Субнациональные территории → Владения → Алиасы владений → Надгосударственные регионы → Исторические страны → Обычные названия стран → Неоднозначности. Первыми будут обнаруживаться страны из группы официальный названий стран по алфавитной очерёдности и далее по списку. Для каждой отдельной страны написания в разных падежах обнаруживаются в традиционном порядке, начиная от именительного.

Использование

[править код]

Обычное использование

[править код]

{{Поиск страны|текст}}

Подобное использование возвращает из строки «текст» первое по очередности совпадение с правильным написанием страны из таблицы стран.

Если совпадения не найдено, возвращается пустая строка. Это позволяет просто использовать его в шаблонах, например

{{#if:{{Поиск страны}}|<!-- ничего не делать, если есть совпадение -->|Эта строка не содержит страну}}

Необязательные параметры

[править код]

Один параметр является обязательным, три других параметра необязательны:

  • |case = падеж
Возвращает название обнаруженной страны в запрашиваемом падеже. Падежи указываются русскоязычным строчным написанием. Дополнительный вариант «предлог» отображает написание страны в предложном падеже с предлогом «в/во/на»:
Значение case Пример заполнения Результат
{{Поиск страны|На Кипре был ясный день}} Кипр
именительный {{Поиск страны|На Кипре был ясный день|case=именительный}} Кипр
родительный {{Поиск страны|На Кипре был ясный день|case=родительный}} Кипра
дательный {{Поиск страны|На Кипре был ясный день|case=дательный}} Кипру
винительный {{Поиск страны|На Кипре был ясный день|case=винительный}} Кипр
творительный {{Поиск страны|На Кипре был ясный день|case=творительный}} Кипром
предложный {{Поиск страны|На Кипр пришёл ясный день|case=предложный}} Кипре
предлог {{Поиск страны|На Кипр пришёл ясный день|case=предлог}} на Кипре
  • |string = значение
Обработка заданной строки, вместо обработки названия текущей страницы (по-умолчанию)
  • |nomatch = значение
Задаёт сообщение, которое будет выдаваться, если страна не найдена. Например
  • С nomatch: {{Поиск страны|Строка текста без упоминания стран|nomatch=Нет страны!}} → Нет страны!
  • |match = число
  • По умолчанию: {{Поиск страны|Строка текста без упоминания стран}}
Если в строке находятся несколько названий стран, то этот параметр регулирует какое по счёту совпадение возвращать. Первое совпадение слева возвращается через match=1, второе match=2 и т.д. Отсчёт совпадений справа указывается через отрицательное число. То есть match=-1 означает выдачу последнего найденного в строке, match=-2 - предпоследнего и т.д. По умолчанию значение равно 1.
  • {{Поиск страны|События в Египте, Индии и Пакистане (и, возможно, Шри-Ланке) |match = 2}} → Индия
  • {{Поиск страны|События в Египте, Индии и Пакистане (и, возможно, Шри-Ланке) |match = -2}} → Пакистан

TemplateData

[править код]
Здесь приведена документация в формате TemplateData для данного шаблона, которая используется в TemplateWizard, визуальном редакторе и прочих инструментах. Смотрите ежемесячный отчет об использовании параметров этого шаблона в статьях.

Извлекает название страны из строки.

Параметры шаблона[Править данные шаблона]

Шаблон использует строчное форматирование параметров.

ПараметрОписаниеТипСтатус
Строка текстаstring

Строка для поиска страны. Если оставить пустым, шаблон вернет пустое значение, тогда как сам модуль будет использовать название страницы

Строковый (без форматирования)необязательный
Падеж результатаcase

Указание падежа, в каком нужно получить название страны.

Предлагаемые значения
именительный родительный дательный винительный творительный предложный предлог
Однострочныйнеобязательный
Номер совпаденияmatch

Если найдено несколько стран, это указывает, какое совпадение возвращать, где первое совпадение: match=1. Если указано отрицательное число, то возвращается совпадение, считая с последнего совпадения. Таким образом, match = -1 - это то же самое, что и запрос последнего совпадения. По умолчанию равно 1.

По умолчанию
1
Числонеобязательный
Текст несовпаденияnomatch

Если не найдено ни одной страны, выводится значение «nomatch». По умолчанию пустое.

Строковый (без форматирования)необязательный

См. также

[править код]