Перейти к содержанию

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

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

Шаблон извлекает из строки название страны в каком-угодно падеже и возвращает название в любом падеже, по умолчанию в именительном. Возвращает ничего, если нет совпадений. Использует Модуль:Find topic с параметром data=country.

Поиск регистронезависимый: «Индия», «индия» и «ИНДИЯ» будут найдены одинаково. Результат возвращается в том виде, как записан в таблице (с заглавной буквы за редкими исключениями).

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

Организация списка стран

Страны объединены в условные группы для удобства навигации. При наличии нескольких совпадений модуль автоматически выбирает более длинное (например, «Британская Индия» вместо «Индия»).

Очерёдность групп:

  1. «Названия стран»,
  2. «Альтернативные названия стран»,
  3. «Внутренние автономии или части суверенных государств»,
  4. «Непризнанные или частично признанные государства»,
  5. «Альтернативные названия непризнанных или частично признанных государств»,
  6. «Исторические страны»,
  7. «Зависимые территории»,
  8. «Альтернативные названия зависимых территорий»,
  9. «Неоднозначности»

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

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

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

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

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

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

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

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

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

TemplateData

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

Извлекает название страны из строки и возвращает его в нужном падеже.

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

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

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

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

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

Падеж, в котором вернуть название страны.

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

Какое по счёту совпадение возвращать. Положительное число — отсчёт слева, отрицательное — справа (-1 = последнее).

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

Значение, возвращаемое если страна не найдена.

По умолчанию
Строковый (без форматирования)необязательный
Регистр первой буквыfirst

Управление регистром первой буквы результата.

Предлагаемые значения
upper lower keep
Однострочныйнеобязательный

См. также