Модуль:CenturyMetaCat/doc

Материал из Википедии — свободной энциклопедии
(перенаправлено с «Модуль:CenturyNavbox/doc»)
Перейти к навигации Перейти к поиску

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

Возможности

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

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

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

[править код]
{{#invoke:CenturyMetaCat|main
|Мир в <век> веке по странам
|Мир <тысячелетие>-го тысячелетия <страны>!<ключ>
|Мир по векам <в части света>!<ключ>
}}

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

Примеры:

  • |Мир по векам! <ключ> — добавлять категорию «Мир по векам» с ключом сортировки <пробел><ключ>.
  • |Графы Средних веков!<ключ>!5!15 — добавлять категорию «Графы Средних веков» в категории с V по XV века.
  • |Книги в общественном достоянии!<ключ>!!19 — добавлять категорию «Книги в общественном достоянии» во все категории до XIX века включительно.

Переменные

[править код]
  • <век> — век римскими цифрами без слова «век»
  • <тысячелетие> — тысячелетие числом (без окончания -е/-м/-го)
  • <ключ> — ключ сортировки, н. э. — номер века числом, до н. э. — отрицательное число начиная с -99 (-99 == I век до н. э. -98 == II век до н. э. и т. д.); для корректной сортировки у годов до н. э. перед минусом добавляется 0
  • <страна><страны>, <в стране> — страна в необходимом падеже
  • <часть света><части света>, <в части света> — часть света в необходимом падеже
  • <государство><государства>, <в государстве> — государство в необходимом падеже
    • <государство:Название><государства:Название>, <в государстве:Название> — дополнительная проверка, позволяющая публиковать категорию только для стран, входящих в конкретное государство. Использование символа ^ перед названием государства, наоборот, исключает его из публикации среди всех остальных государств. Можно исключать сразу несколько государств, отделяя каждое из них символом ^. Для установки сложных условий отображения см. Модуль:CountryMetaCat/State.

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

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

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

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

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

[править код]
{{#invoke:CenturyMetaCat|main
|Категория 1![ключ сортировки]![диапазон веков от]![диапазон веков до]
|?Категория 2![ключ сортировки]![диапазон веков от]![диапазон веков до]
|~Категория 3![ключ сортировки]![диапазон веков от]![диапазон веков до]
...
|Категория N[...]
|min = до какого века рисовать линейку слева, по умолчанию -39 (0 — рисовать только века нашей эры)
|max = до какого века рисовать линейку справа, по умолчанию 21
|range = сколько веков в линейке слева и справа, по умолчанию 5
}}

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

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

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

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

expand

  • заменяет <век> на текущий, по необходимости добавив «до н. э.»
  • заменяет <тысячелетие> на текущее, по необходимости добавив «до н. э.»
  • заменяет <ключ> на ключ сортировки

Например, {{#invoke:CenturyMetaCat|expand|Мир в <век> веке}} на странице Категория:Земля I века до н. э. вернёт Мир в I веке до н. э..

Страны и части света функция не обрабатывает.

century_from_title

Возвращает век из заголовка числом, для веков до н. э. с минусом.

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

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

См. также

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

Это страница документации Модуль:CenturyMetaCat.