Модуль:CountryMetaCat/doc

Модуль:CountryMetaCat Документация Обсуждение Где используется

Модуль используется для автокатегоризации категорий по странам (для категорий с заголовком, включающим ).

Возможности

• Обработка стран:
  • Определяет страну из заголовка в любом падеже.
  • Позволяет изменить падеж страны для категорий.
  • Определяет, в каких частях света расположена страна и публикует их в выбранном падеже.
  • Определяет, в какое государство входит (входила) страна, исходя из текущего века, позволяя опубликовать категории для любых государств в одном формате, либо указывать отдельные категории для выбранных государств.
• Позволяет проверить существование категории и опубликовать одну или несколько замен для неё.
• Добавляет {{автоиндекс}} (появляется от 200 статей, расширенный индекс от 1200 статей).

• Добавляет категории.

Используемые списки данных для стран:

• падежные формы стран с предлогом
• разделение стран по частям света
• вхождение стран в государства по годам

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

{{#invoke:CountryMetaCat|main
|Появились <в стране>
|События <части света>!текст для сортировки
}}

Категория состоит из 4-х частей, разделенных ! (восклицательным знаком). Первая часть — название категории, вторая часть — ключ сортировки (необязателен).

Переменные

• <страна>, <страны>, <в стране> — страна в необходимом падеже
• <часть света>, <части света>, <в части света> — часть света в необходимом падеже
• <государство>, <государства>, <в государстве> — государство в необходимом падеже
  • <государство:Название>, <государства:Название>, <в государстве:Название> — дополнительная проверка, позволяющая публиковать категорию только для стран, входящих в конкретное государство. Использование символа ^ перед названием государства, наоборот, исключает его из публикации среди всех остальных государств. Можно исключать сразу несколько государств, отделяя каждое из них символом ^. Для установки сложных условий отображения см. Модуль:CountryMetaCat/State.

Именительный, родительный и предложный падежи для стран, частей света и государств подставляются автоматически, соответственно указанным переменным. Вариант предложного падежа у стран и государств автоматически выводится с нужным предлогом «в/во/на». Для частей света в предложном падеже автоматически ставится предлог «в».

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

• ? — категория публикуется только если она существует.
• ~ — является заменой для несуществующей категории ?. Обязательно должна следовать сразу за ней на следующей строке, иначе игнорируется. Замены публикуются без проверок на существование. Для одной проверяемой категории может указываться несколько замен подряд.

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

Полная версия

{{#invoke:CountryMetaCat|main
|Категория 1![ключ сортировки]
|?Категория 2![ключ сортировки]
|~Категория 3![ключ сортировки]
...
|Категория N[...]
}}

Дополнительные параметры:

|title = заголовок страницы, используемый вместо текущего (для тестов)
|noindex = 1 (указывается, если необходимо отключить добавления шаблона индекса)

Дополнительные функции

resolve_country

Функция используется для экспорта в другие модули. Принимает заголовок страницы (или принимает title) + строку. Обрабатывает строку, если в ней содержалась заготовка страны, части света или государства. Возвращает таблицу со значениями:

• result — основной вариант строки для единственного результата (или первой части света или государства),
• extra_result — возможный второй вариант строки для второй части света или государства,
• error — код ошибки (0 — ошибки нет, 1 — страна не найдена, 2 — часть света не найдена).

Категории отслеживания

• Википедия:Страницы с некорректным использованием модуля CountryMetaCat — отслеживание использований с несуществующими странами или частями света, а также с нарушениями диапазонов в навигационной линейке.
• Шаблоны, использующие модуль CountryMetaCat (25) — в модуль встроено автодобавление в эту категорию страниц, на которых он используется, при условии что страница является шаблоном. Однако, так как проверка пространства страницы и размещение происходит через код модуля, то необходимо избегать помещения модуля в тег <includeonly></includeonly> на странице шаблона. Модуль нужно размещать вне любых подобных тэгов.
• Категория:Шаблоны, использующие индекс категории (автоматический)

См. также

• Модуль:YearMetaCat2 — аналог для годов
• Модуль:DecadeMetaCat — аналог для десятилетий
• Модуль:CenturyMetaCat — аналог для веков
• Модуль:YearMetaCat — аналог для годов и десятилетий
• Модуль:MetaCatDoc — для документирования шаблонов, использующих этот модуль