Волшебные слова

Информация о количестве статей выводится с помощью волшебных слов

Волшебные слова — особые слова или фразы, которые распознаются движком MediaWiki и запускают особый процесс их обработки. Волшебные слова влияют на оформление и/или поведение страницы, а также позволяют вывести некоторые переменные из базы данных.

Описание

Чтобы добавить волшебное слово, его необходимо просто поместить внутри любой страницы. Почти всегда результат можно увидеть уже на этапе предпросмотра.

Волшебные слова могут быть добавлены в любом редакторе (как в визуальном, так и в исходном коде). Тем не менее, чтобы изменить волшебное слово, необходимо работать в исходном коде. В качестве альтернативы в визуальном редакторе можно просто удалить старое волшебное слово и вместо него добавить новое.

Всего существуют три вида волшебных слов:

• Переключатели поведения: ими являются слова, написанные большими буквами и обрамлённые двойным подчеркиванием (например, __NOTOC__)
• Переменные: они также используют заглавные буквы, но они заключены в двойные фигурные скобки (например, {{SITENAME}}). По своему строению они похожи на шаблоны.
• Функции парсера: выглядят почти так же, как и переменные, но после открывающих фигурных скобок идёт знак решётки. Кроме того, функции парсера могут принимать параметры (например, {{#invoke:}}).

Также в отдельную группу можно вынести уникальные для Фэндома волшебные слова, которые используются только в навигационном меню и категориях-галереях.

Полный список волшебных слов можно увидеть на специальной странице MediaWiki. Стоит учесть, что не все волшебные слова из списка будут поддерживаться, так как версия MediaWiki на Фэндоме не является последней (более точную информацию можно увидеть на соответствующей служебной странице).

Переключатели поведения

Переключатели поведения влияют на оформление и поведение страниц и часто используются для того, чтобы скрыть или показать некоторый элемент. Ниже приведены некоторые волшебные слова из этой группы:

• __NOTOC__ скрывает содержание на странице.
• __FORCETOC__ заставляет оглавление появиться в обычном месте — перед первым заголовком (даже если оно состоит из одного раздела). Отменяет действие NOTOC.
• __TOC__ помещает содержание страницы туда, где находится волшебное слово. Отменяет действие NOTOC.
• __NOEDITSECTION__ скрывает ссылки «править» для каждой секции страницы.
• __HIDDENCAT__ используется для категорий и позволяет скрыть её и нижеследующие из более старших категорий.
• __NOWYSIWYG__ отключает визуальный редактор на странице; при попытке переключиться на него появится сообщение, что страница содержит сложный код.

Переменные

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

Если имя шаблона совпадает с переменной, то вызывается переменная (если у вас есть шаблон {{CURRENTYEAR}}, то для его вызова придётся ввести {{Template:CURRENTYEAR}}); именно поэтому не рекомендуется именовать шаблоны так же, как и переменные.

Ниже приведены некоторые волшебные слова из этой группы:

• {{NUMBEROFARTICLES}} — число страниц в основном пространстве в рамках вики.
• {{NUMBEROFPAGES}} — общее число страниц на проекте.
• {{NUMBEROFFILES}} — общее число файлов на проекте.
• {{SITENAME}} — выводит название вики.
• {{PAGENAME}} — отображает название страницы, на которой было добавлено данное волшебное слово без указания пространства имён. Для страницы «Справка:Содержание/ru» результатом будет «Содержание/ru».
• {{BASEPAGENAME}} — отображает название страницы без указания пространства имён и без предыдущей подстраницы. Для страницы «Справка:Содержание/ru» результатом будет «Содержание».
• {{SUBPAGENAME}} — отображает название подстраницы. Для страницы «Справка:Содержание/ru» результатом будет «ru».
• {{FULLPAGENAME}} — отображает название страницы с учётом пространства имён и подстраниц. Для страницы «Справка:Содержание/ru» результатом будет «Справка:Содержание/ru».
• {{DISPLAYTITLE:Заголовок}} — изменяет верхний заголовок текущий страницы (изменения видны в названии вкладки).
• {{DEFAULTSORT:Ключ}} — устанавливает ключ сортировки во всех категориях, где используется эта страница: если для страницы «Яблоко» использовать {{DEFAULTSORT:Б}}, то страница в категориях будет находиться в разделе на букву «Б».
• {{NUMBEROFEDITS}} — общее количество правок.
• {{NUMBEROFUSERS}} — количество участников вики.
• {{NUMBEROFADMINS}} — количество администраторов википроекта.
• {{NUMBEROFACTIVEUSERS}} — количество активных участников, на основе критериев, используемых в статистике.
• {{CURRENTDAY}} — указывает текущую дату по григорианскому календарю.
• {{CURRENTMONTHNAME}} — указывает текущий месяц по григорианскому календарю.
• {{CURRENTMONTHNAMEGEN}} — месяц в родительном падеже.
• {{CURRENTMONTHABBREV}} — текущий месяц (аббревиатура).
• {{CURRENTMONTH}} — месяц (номер с дополнением нулями до двузначного числа).
• {{CURRENTMONTH1}} — месяц (обычный порядковый номер).
• {{CURRENTYEAR}} — указывает текущий год по григорианскому календарю.
• {{CURRENTTIME}} — указывает текущее время по UTC.
• {{CURRENTHOUR}} — указывает час по UTC.
• {{CURRENTWEEK}} — текущая неделя по григорианскому календарю.
• {{CURRENTTIMESTAMP}} — отметка времени в формате YYYYMMDDHHmmss.
• {{REVISIONSIZE}} — размер страницы в байтах викитекста.

Функции парсера

Функции парсера похожи на переменные, но принимают один или более аргументов (на самом деле любые магические слова, принимающие аргументы, являются функциями парсера). Имена функций могут начинаться с символа «#», чтобы не путать их с шаблонами.

Ниже будут рассмотрены волшебные слова, которые предоставляются в MediaWiki (здесь не будут использоваться функции парсера из расширения ParserFunctions):

• {{PAGESIZE:название страницы}} — отображает размер некоторой страницы. Для получения числа без форматирования нужно добавить в конце |R. Данное волшебное слово является «затратным» и количество его включений на одной странице ограничено.
• {{filepath:Wiki-wordmark.png|размер|nowiki}} — без дополнительных параметров возвращает указанное изображение. При задании размера на странице будет изменённое изображение (его можно только уменьшить), а если ещё добавить параметр nowiki — ссылка будет изменена для получения изображения заданной ширины (если размер не задан — то ссылка будет для исходного разрешения файла).
• {{ns:}} — возвращает название пространства имён. В качестве параметра можно указать номер пространства или его название.
• {{#special:название служебной страницы}} — отображает на странице локализованное название некоторой служебной страницы.
• {{plural:число|is|are}} — выводит форму множественного или единственного числа в зависимости от значения первого параметра (единственное число выводится только для 1 и -1). В русском языке используются четыре параметра из-за ещё одной дополнительной формы (в результате {{PLURAL:3|страница|страницы|страниц}} выведет «страницы», а {{PLURAL:5|страница|страницы|страниц}} — «страниц»).
• {{{#tag:название тега|содержимое|параметр1=значение1|параметр2=значение2|...}} — альтернативный способ использования тегов, при котором сначала обрабатывается его содержимое. Таким образом, при использовании {{#tag:ref|Текст примечания|name="multiple"}} создастся примечание, содержащее в себе подпись участника, а не три тильды.

Специфические волшебные слова

Навигационное меню

Указанные ниже волшебные слова используются при редактировании навигационного меню и используются для его автоматического заполнения:

• #categoryX# — где X больше 0. В результате создаётся список из топ-8 страниц из X по счёту самой большой категории на вики.
• #category-X# — добавляет топ-8 страниц из Категория:X.
• #visited# — выводит список наиболее посещаемых страниц.
• #newlychanged# — добавляет недавно отредактированные статьи.
• #topusers# — отображает список наиболее активных участников на проекте.

Категории-галереи

Данные волшебные слова применяются только при включенных категориях-галереях:

• __NOCATEGORYGALLERY__ — скрывает категорию-галерею на странице категории.
• __FORCECATEGORYGALLERY__ — если расширение категории-галереи включено на сообществе, но не задействовано на странице категорий, то это добавит её туда.

Применение

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

Рассматривая наиболее часто используемые слова, можно отметить {{PAGENAME}}, которое позволяет избежать проблем с обновлением заголовков текста или шаблонов при переименовании страницы или {{SITENAME}}, которое особенно удобно использовать при длинном и/или сложном названии вики. Кроме того, волшебные слова используются в системных сообщениях (особенно много их в описаниях к достижениям).

Интересные факты

• В рамках Фэндома участники не могут создавать свои собственные волшебные слова.
• На некоторых проектах используют волшебное слово {{DEFAULTSORT:*}} для выделения ключевых элементов в категории для того, чтобы они были в самом её начале (например, страницы альбомов среди множества страниц о саундтреках).
• Существует баг с волшебным словом {{NUMBEROFACTIVEUSERS}}: иногда оно выдаёт отрицательное значение −1.