Пространства имён: что это?

Пространство имён — часть названия страницы до двоеточия, например «Шаблон:» или «Категория:». Оно говорит движку, что это за страница. Статьи живут в основном пространстве, у которого приставки нет.

Зачем они нужны

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

Большинство страниц вашей вики должно лежать в основном пространстве. Так желательно и для читателей, и для поиска.

Какие пространства есть сразу?

Номер Название в русской вики Что там лежит
0 без приставки статьи
2 Участник: личные страницы участников
4 название вики правила и страницы о самом проекте
6 Файл: описания загруженных файлов
8 MediaWiki: тексты интерфейса, которые можно поменять
10 Шаблон: шаблоны
12 Справка: справка для участников
14 Категория: категории
-1 Служебная: страницы, которые строит сам движок
-2 Медиа: прямые ссылки на файлы

У каждого пространства с чётным номером есть пара — пространство обсуждения со следующим нечётным номером: 1 — Обсуждение:, 3 — Обсуждение участника:, 11 — Обсуждение шаблона: и так далее. У служебных пространств -1 и -2 обсуждения нет, и создать в них страницу нельзя.

Английские названия, Template: или Category:, работают в вики на любом языке. Это удобно, когда пример взят из англоязычной инструкции.

Как добавить своё пространство?

Своё пространство пригодится, когда в вики есть отдельный большой раздел, который не должен смешиваться со статьями: например, рецепты в кулинарной энциклопедии. Добавьте в конец LocalSettings.php:

LocalSettings.php
define( 'NS_RECIPE', 3000 );
define( 'NS_RECIPE_TALK', 3001 );
$wgExtraNamespaces[NS_RECIPE] = 'Рецепт';
$wgExtraNamespaces[NS_RECIPE_TALK] = 'Обсуждение_рецепта';

Правила такие:

  • номер самого пространства чётный, номер его обсуждения — на единицу больше;
  • свои пространства принято нумеровать от 3000, чтобы не занять номер, который использует какое-нибудь расширение;
  • пробелы в названии заменяют подчёркиванием;
  • имена констант (NS_RECIPE) должны быть уникальными.

Какие настройки пригодятся вместе с ним?

LocalSettings.php
$wgContentNamespaces[] = NS_RECIPE;
$wgNamespacesToBeSearchedDefault[NS_RECIPE] = true;
$wgNamespacesWithSubpages[NS_RECIPE] = true;
  • $wgContentNamespaces — страницы пространства считаются статьями в статистике вики.
  • $wgNamespacesToBeSearchedDefault — поиск по умолчанию ищет и здесь.
  • $wgNamespacesWithSubpages — разрешает подстраницы вида Рецепт:Борщ/Постный.

Что делать со страницами, созданными раньше?

Если страницу «Рецепт:Борщ» создали до того, как появилось пространство, она так и осталась в основном пространстве с двоеточием в названии. После добавления пространства такие страницы перестанут открываться. Перенесите их скриптом:

терминал
php maintenance/run.php namespaceDupes --fix

Сначала сделайте резервную копию базы: скрипт меняет названия страниц.

Где почитать подробнее

Что-то не сработало или устарело? Напишите в чат или предложите исправление.