Редактирование: Модуль:CenturyMetaCat/doc

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

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

* <code><век></code> — век римскими цифрами без слова «век»
* <code><тысячелетие></code> — тысячелетие числом (без окончания -е/-м/-го)
* <code><ключ></code> — ключ сортировки, н. э. — номер века числом, до н. э. — отрицательное число начиная с -99 (-99 == I век до н. э. -98 == II век до н. э. и т. д.); нужен для корректной сортировки в категориях

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

=== Категории ===
Категория состоит из 4-х полей, разделенных <code>!</code> (восклицательным знаком):
* первое — название категории
* второе — [[ВП:КЛЮЧ|ключ сортировки]] (необязательно)
* третье — начиная с какого века добавлять категорию (необязательно)
* четвертое — каким веком заканчивать добавление категории (необязательно)

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

;{{NB}}
Есть эмпирическое правило: в категории обязательно должен быть или <век> (в названии), или <ключ> (в ключе сортировки), но не оба.

=== Другие опции ===
<pre>
|min = до какого века рисовать линейку слева, по умолчанию -39 (0 — рисовать только века нашей эры)
|max = до какого века рисовать линейку справа, по умолчанию 21
|range = сколько веков в линейке слева и справа, по умолчанию 5
|title = заголовок страницы, используемый вместо текущего (для тестов)
</pre>

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

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

Пример:
<pre>{{#invoke:CenturyMetaCat|expand|Мир в <век> веке}}</pre>
на странице «К:Земля I века до н. э.» вернёт:
 {{#invoke:CenturyMetaCat|expand|Мир в <век> веке|title=Земля I века до н. э.}}

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

== См. также ==
* [[Модуль:YearMetaCat]] — аналог для годов и десятилетий
* [[Модуль:YearMetaCat2]] — аналог для годов
* [[Модуль:DecadeMetaCat]] — аналог для десятилетий
* [[Модуль:MetaCatDoc]] — для документирования шаблонов, использующих этот модуль

<includeonly>
[[Категория:Модули:Категоризация]]
</includeonly>