Справка:Волшебные слова

«Волшебные слова» в MediaWiki — комбинации текста, управляющие поведением, оформлением той или иной страницы в вики, а также выводящие некоторые полезные переменные из базы данных. Более подробную техническую информацию см. в mediawikiwiki:Manual:Magic words.

Do you want to try some new features? By joining the beta, you will get access to experimental features, at the risk of encountering bugs and issues.

Ок Нет, спасибо

Основные замечания

  • Наследование: переменные и «магические выражения», зависящие от страницы, возвращают значения в зависимости от просматриваемой страницы, независимо от того, присутствуют они в коде страницы или включены через другую страницу.

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

Переключатели поведения — «волшебные слова», влияющие на оформление страниц в вики.

Выражение Описание Версия
Содержание
__NOTOC__ Скрывает оглавление страницы (TOC).
__FORCETOC__ Заставляет содержание подниматься выше определённого уровня (в нулевой секции).
__TOC__ Размещает оглавление в текущую позицию (противоположно «слову» __ NOTOC __). Если используется _TOC_, то оглавление вернётся в исходное место на странице.
Редактирование
__NOEDITSECTION__ Скрывает ссылки «править» для каждой секции страницы
__NEWSECTIONLINK__ Добавляет кнопку ((«+» по умолчанию) рядом с кнопкой «править» на любых страницах (см. m:Help:Section#Adding a section at the end). 1.7+
Категории
__NOGALLERY__ Используется для категорий, в которые включено большое количество изображений. Это «слово» заменяет изображения на простые ссылки. 1.7+
__HIDDENCAT__ Используется в категории и позволяет скрыть эту категорию из более старших категорий (в которые включена данная категория) (более подробно — см. настройки участника). 1.13+
{{DEFAULTSORT:xyz}} Устанавливает ключ сортировки на сортируемой странице 1.10+
Преобразование языков
__NOCONTENTCONVERT__
__NOCC__
Запрещает выполнение языковой конвертации содержания на сайтах с языковыми вариантами. Например, будет отображён только китайский (zh), вместо таких вариантов, как zh_cn, zh_tw, zh_sg, или zh_hk.
__NOTITLECONVERT__
__NOTC__
Запрещает выполнение языковой конвертации заголовка на сайтах с языковыми вариантами (прочее содержание будет проходить конверсию).
Разное
{{DISPLAYTITLE:xyz}} Форматирует заголовок текущей страницы. Значение должно быть эквивалентно стандартному заголовку: допустимо лишь изменение регистра и замена пробелов на подчёркивания. Функцию можно отключить через переменную $wgAllowDisplayTitle; по умолчанию отключена до 1.10+, затем включена. 1.7+
__END__ Обозначает конец страницы, не давая MediaWiki удалить её. Функция удалена, см. 19213.
__START__ Нет эффекта.
__NOINDEX__ Запрещает индексацию страницы поисковыми системами (страница не будет отображена в результатах поиска). 1.13+
__INDEX__ Позволяет поисковым системам индексировать страницу (переписывает $wgArticleRobotPolicies, но не robots.txt). 1.13+
__STATICREDIRECT__ Помещённая на страницу перенаправления, запрещает MediaWiki автоматически исправлять двойные перенаправления. 1.13+
#REDIRECT [[Page name]] Перенаправляет с текущей страницы на другую.

Переменные

Синтаксис большинства переменных похож на синтаксис шаблонов, но для избежания конфликтов обычно использует только заглавные буквы. Если имя шаблона совпадает с переменной, то вызывается переменная; для принудительного вызова шаблона используйте префикс msg:, например {{msg:CURRENTYEAR}}. В некоторых случаях, добавление параметров может вызвать подключение шаблона; например, {{CURRENTDAYNAME|x}} приведёт в включению шаблона «Шаблон:CURRENTDAYNAME».

Функции парсера похожи на переменные, но срабатывают на месте ввода, а не на всей странице. Первый параметр отделён двоеточием (:), а не вертикальным слэшем (|). (На этой странице не описаны функции расширения ParserFunctions extension.)

Дата и время

Следующие переменные возвращают текущую дату и время, основываясь на часовом поясе пользователя, указанном в настройках. Часовой пояс по умолчанию — UTC.

Вследствие кэширования страниц браузером и MediaWiki, эти переменные часто показывают когда страница была закэширована, вместо отображения текущего времени.

Переменная Возвращаемое значение Описание Версия
Год
{{CURRENTYEAR}} 2025 Год
Текущий месяц
{{CURRENTMONTH}} 04 Месяц (число)
{{CURRENTMONTHNAME}} апрель Текущий месяц (название)
{{CURRENTMONTHNAMEGEN}} апреля Текущий месяц (в родительном падеже)
{{CURRENTMONTHABBREV}} апр Текущий месяц (аббревиатура) 1.5+
День
{{CURRENTDAY}} 25 День месяца (1..31)
{{CURRENTDAY2}} 25 День месяца (с ведущим нулём: 01..31) 1.6+
{{CURRENTDOW}} 5 День недели (число)
{{CURRENTDAYNAME}} пятница День недели (название)
Время
{{CURRENTTIME}} 08:53 Текущее время (24-часовой формат — HH:mm)
{{CURRENTHOUR}} 08 Час (01..24)
Разное
{{CURRENTWEEK}} 17 Текущая неделя (число)
{{CURRENTTIMESTAMP}} 20250425085342 Время по стандарту ISO 8601 1.7+

Следующие переменные возвращают подобные значения, что и выше, но используют локальный часовой пояс, не зависимо от настроек пользователя и UTC:

  • {{LOCALYEAR}}
  • {{LOCALMONTH}}
  • {{LOCALMONTHNAME}}
  • {{LOCALMONTHABBREV}}
  • {{LOCALDAY}}
  • {{LOCALDAY2}}
  • {{LOCALDOW}}
  • {{LOCALDAYNAME}}
  • {{LOCALTIME}}
  • {{LOCALHOUR}}
  • {{LOCALWEEK}}
  • {{LOCALTIMESTAMP}}

Технические метаданные

Следующие переменные возвращают значения, связанные с последней правкой текущей статьи, независимо от просматриваемой версии.

Переменная Возвращаемое значение Описание Версия
Сайт
{{SITENAME}} YourcmcWiki Имя сайта ($wgSitename)
{{SERVER}} http://yourcmc.ru URL домена($wgServer)
{{SERVERNAME}} yourcmc.ru доменное имя ($wgServerName)
{{DIRMARK}}
{{DIRECTIONMARK}}

Outputs a unicode-directional mark that matches the wiki's default language's direction (‎ on left-to-right wikis, ‏ on right-to-left wikis), useful in text with multi-directional text. 1.7+
{{SCRIPTPATH}} /wiki относительный путь к скрипту ($wgScriptPath)
{{CURRENTVERSION}} 1.26.4 (9c1e179) Версия MediaWiki, на которой работает вики-проект. 1.7+
{{CONTENTLANGUAGE}} ru Язык интерфейса по умолчанию ($wgLanguageCode) 1.7+
Последняя правка статьи
{{REVISIONID}} 3989 Уникальный идентификатор правки
{{REVISIONDAY}} 26 День совершения правки (без ведущего нуля)
{{REVISIONDAY2}} 26 День совершения правки (с ведущим нулём)
{{REVISIONMONTH}} 03 Месяц совершения правки (без ведущего нуля)
{{REVISIONYEAR}} 2010 Год совершения правки
{{REVISIONTIMESTAMP}} 20100326211700 Дата совершения правки в формате ISO 8601
{{PAGESIZE:page name}} 56 Returns the byte size of the specified page. 1.13+
{{PROTECTIONLEVEL:action}} уровень защиты Регуляция уровня защиты (например, 'autoconfirmed', 'sysop') для определённого уровня (например, 'edit', 'move') на текущей странице, если таковая не защищена обычным способом. 1.15+
Воздействие на содержимое страницы
{{DISPLAYTITLE:title}} «Слово» позволяет изменять верхний заголовок страницы. Для полной работы этой функциональности требуется выключенная в LocalSettings.php переменная $wgAllowDisplayTitle; она была отключена до версии 1.10+ и включена во всех последующих версиях. 1.7+
{{DEFAULTSORT:sortkey}} Используется на страницах категорий, устанавливает ключ сортировки в категории по умолчанию. 1.10+

Статистика

Числа, возвращаемые этими переменными, содержат разделители разрядов. Для получения неотформатированных чисел используется флаг «:R» (например, {{NUMBEROFPAGES}} = 2362 и {{NUMBEROFPAGES:R}} = 2362). Для волшебных слов, требующих параметра, таких как PAGESINCATEGORY, используйте «|R» (например, {{PAGESINCATEGORY:Help}} и {{PAGESINCATEGORY:Help|R}}).

Переменная Возвращаемое значение Описание Версия
По вики-проекту в целом
{{NUMBEROFPAGES}} 2362 Количество вики-страниц 1.7+
{{NUMBEROFARTICLES}} 249 Количество страниц в основном пространстве
{{NUMBEROFFILES}} 1277 Количество загруженных файлов 1.5+
{{NUMBEROFEDITS}} 15 249 Общее количество правок. 1.10+
{{NUMBEROFUSERS}} 1935 Количество зарегистрированных участников. 1.7+
{{NUMBEROFADMINS}} 4 Количество участников, входящих в группу sysop. См. права участников. 1.7+
{{NUMBERINGROUP:groupname}} 2
({{NUMBERINGROUP:bureaucrat}}, число бюрократов)
Число пользователей определённой группы. 1.14+
По пространствам имён

{{PAGESINNS:2}}
{{PAGESINNAMESPACE:2}}

отключено Количество страниц в заданном пространстве имён (замените 2 на ID нужного пространства имён). Запрещено по умолчанию, разрешается через $wgAllowSlowParserFunctions. 1.7+
Разное
{{PAGESINCATEGORY:Help}} 1 Количество страниц в заданной категории (замените «Help» на имя нужной категории). 1.13+
{{PAGESINCAT:Help}} 1 Алиас для {{PAGESINCATEGORY}}. 1.13+
{{PAGESIZE:Help:Magic_words}} 56 Возвращает размер в байтах заданной страницы. 1.13+

Ссылки

Ссылки

Переменная Возвращаемое значение Описание Версия
{{SERVER}} http://yourcmc.ru Доменная ссылка ($wgServer)
{{SERVERNAME}} yourcmc.ru Имя домена ($wgServerName)
{{SCRIPTPATH}} /wiki Относительный путь к MediaWiki ($wgScriptPath)
{{localurl:название страницы}}
{{localurl:название страницы|строка запроса}}
/wiki/Pagename
/wiki/index.php?title=Pagename&query string
Относительный путь к странице
{{fullurl:page name}}
{{fullurl:page name|query_string}}
http://yourcmc.ru/wiki/Page_name
http://yourcmc.ru/wiki/index.php?title=Page_name&query_string
полная ссылка на страницу
{{filepath:file name}}
{{filepath:file name|nowiki}}

Полная ссылка на файл (есть ошибки с использованием nowiki) r25854
{{urlencode:x y z}} x+y+z Кодирование для URL-адреса. 1.7+
{{anchorencode:x y z}} x_y_z Кодирование URL после символа '#' (якорей). 1.8+

Названия страниц

Переменная Возвращаемое значение Описание Версия
{{FULLPAGENAME}} Справка:Волшебные слова Пространство статей и название страницы
{{BASEPAGENAME}} Волшебные слова Название страницы без текущей подстраницы и без указания пространства статей («Статья» на «Статья/test»)
{{PAGENAME}} Волшебные слова Название страницы 1.7+
{{SUBPAGENAME}} Волшебные слова Название подстраницы («test» на «Страница/test») 1.6+
{{SUBJECTPAGENAME}} Справка:Волшебные слова Название основной страницы статьи. 1.7+
{{TALKPAGENAME}} Обсуждение справки:Волшебные слова Название страницы обсуждения статьи 1.7+

Эквиваленты с URL-кодированием:

  • {{FULLPAGENAMEE}}
  • {{PAGENAMEE}}
  • {{BASEPAGENAMEE}}
  • {{SUBPAGENAMEE}}
  • {{SUBJECTPAGENAMEE}}
  • {{TALKPAGENAMEE}}

Пространство имён

Переменная Возвращаемое значение Описание
{{NAMESPACE}} Справка Пространство имён (название)
{{SUBJECTSPACE}} Справка Пространство имён для текущей статьи
{{TALKSPACE}} Обсуждение справки Пространство имён для текущей страницы обсуждения

Эквиваленты с URL-кодирование:

  • {{NAMESPACEE}}
  • {{SUBJECTSPACEE}}
  • {{TALKSPACEE}}

{{ns:}} возвращает локализованное название пространства имён для указанного числа или константы. Значения по умолчанию:

Использование Возвращаемое значение
{{ns:-2}} или {{ns:Media}} Медиа
{{ns:-1}} или {{ns:Special}} Служебная
{{ns:0}} или {{ns:Main}}
{{ns:1}} или {{ns:Talk}} Обсуждение
{{ns:2}} или {{ns:User}} Участник
{{ns:3}} или {{ns:User_talk}} Обсуждение участника
{{ns:4}} или {{ns:Project}} YourcmcWiki
{{ns:5}} или {{ns:Project_talk}} Обсуждение YourcmcWiki
{{ns:6}} или {{ns:Image}} Файл
{{ns:7}} или {{ns:Image_talk}} Обсуждение файла
{{ns:8}} или {{ns:MediaWiki}} MediaWiki
{{ns:9}} или {{ns:MediaWiki_talk}} Обсуждение MediaWiki
{{ns:10}} или {{ns:Template}} Шаблон
{{ns:11}} или {{ns:Template_talk}} Обсуждение шаблона
{{ns:12}} или {{ns:Help}} Справка
{{ns:13}} или {{ns:Help_talk}} Обсуждение справки
{{ns:14}} или {{ns:Category}} Категория
{{ns:15}} или {{ns:Category_talk}} Обсуждение категории

Форматирование

Переменная Возвращаемое значение Описание Версия
{{lc:XYZ}} xyz Строка в нижнем регистре. 1.5+
{{lcfirst:XYZ}} xYZ Строка с первым символом в нижнем регистре. 1.5+
{{uc:xyz}} XYZ Строка в верхнем регистре. 1.5+
{{ucfirst:xyz}} Xyz Строка с первым символом в верхнем регистре. 1.5+
{{formatnum:-987654321.654321}} -987 654 321,654321 Разделяет дробную часть и разряды согласно установленной локализации 1.7+
{{padleft:xyz|5|_}}
{{padleft:xyz|5}}
__xyz
00xyz
Ввод (первый параметр) дополняется с левой стороны до указанной ширины (второй параметр) с использованием определённых символов (третий параметр). Если третий параметр не указан, строка дополняется нулями.
bug: мультибайтовые символы определяются, как двухбайтовые.
1.8+
{{padright:xyz|5|_}}
{{padright:xyz|5}}
xyz__
xyz00
Аналогично padleft, но дополняет строку с правой стороны.
{{DIRMARK}}
{{DIRECTIONMARK}}

Выводит unicode-символ направления текста, согласно локализации (‎ и ‏, для текста слева-направо и справа-налево, соответственно). Используется для текста с несколькими направлениями. 1.7+
{{plural:2|is|are}} are Выводит форму множественного числа (исключая первый параметр) в зависимости от числа (первый параметр). Например, для определения множественного числа в русском языке используется остаток от деления на 10.

Прочее

Переменная Возвращаемое значение Описание Версия
{{#language:eo}} eo Имя языка по языковому коду. 1.7+
{{#special:userlogin}} Служебная:Вход Локализованное имя для служебных страниц. 1.9+
{{#tag:tagname}}
{{#tag:tagname|inner content|parameter=value|parameter2=value}}
(depends on parser tag) Алиас для тегов парсера или расширений, но с возможностью обработки вики-кода. Значения атрибутов можно передать, как значения параметров ('<tagname attribute="value">' → '{{#tag:tagname|attribute=value}}'), а внутреннее содержание — как безымянный параметр ('<tagname>content</tagname>' → '{{#tag:tagname|content}}'). 1.12+

Собственные переменные

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