Внимание: Когда вы редактируете эту страницу, вы соглашаетесь на передачу вашего вклада в общественное достояние. Если вы не хотите или не можете этого сделать из-за лицензионных ограничений, то, пожалуйста, не редактируйте. Эта страница является одной из страниц справки в общественном достоянии, которые могут свободно копироваться во вновь создаваемые вики-проекты и/или распространяться с ПО MediaWiki; см. содержание справки со списком всех страниц. Инструкции по копированию справки в ваш вики-проект — на странице Project:PD help/Copying/ru. |
«Волшебные слова» в MediaWiki — комбинации текста, управляющие поведением, оформлением той или иной страницы в вики, а также выводящие некоторые полезные переменные из базы данных. Более подробную техническую информацию см. в Magic words.
Существуют три основных типа «волшебных слов»:
- Переключатели поведения: это заглавные буквы обрамлённые двойным подчеркиванием, например, __FOO__
- Переменные: это заглавные буквы в двойных скобках, например, <tt>{{FOO}}</tt>. Как таковые, они очень похожи на шаблоны.
- Функции парсера: эти параметры могут принимать любой вид, будь то <tt>{{foo:...}}</tt> или <tt>{{#foo:...}}</tt>. См. также Help:Extension:ParserFunctions.
Странично-зависимые волшебные слова принимают или возвращают данные о текущей странице (по умолчанию), даже если слово добавляется через раскрываемый шаблон или включённое в текст системное сообщение.
Содержание
Переключатели поведения
Переключатели поведения — «волшебные слова», влияющие на оформление страниц в вики.
Выражение | Описание | Версия |
---|---|---|
Содержание | ||
__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}} | 2024 | Год | |
Текущий месяц | |||
{{CURRENTMONTH}} | 11 | Месяц (число) | |
{{CURRENTMONTHNAME}} | ноябрь | Текущий месяц (название) | |
{{CURRENTMONTHNAMEGEN}} | ноября | Текущий месяц (в родительном падеже) | |
{{CURRENTMONTHABBREV}} | ноя | Текущий месяц (аббревиатура) | 1.5+ |
День | |||
{{CURRENTDAY}} | 14 | День месяца (1..31) | |
{{CURRENTDAY2}} | 14 | День месяца (с ведущим нулём: 01..31) | 1.6+ |
{{CURRENTDOW}} | 4 | День недели (число) | |
{{CURRENTDAYNAME}} | четверг | День недели (название) | |
Время | |||
{{CURRENTTIME}} | 22:55 | Текущее время (24-часовой формат — HH:mm) | |
{{CURRENTHOUR}} | 22 | Час (01..24) | |
Разное | |||
{{CURRENTWEEK}} | 46 | Текущая неделя (число) | |
{{CURRENTTIMESTAMP}} | 20241114225504 | Время по стандарту ISO 8601 | 1.7+ |
Следующие переменные возвращают подобные значения, что и выше, но используют локальный часовой пояс, не зависимо от настроек пользователя и UTC:
- {{LOCALYEAR}}
- {{LOCALMONTH}}
- {{LOCALMONTHNAME}}
- {{LOCALMONTHABBREV}}
- {{LOCALDAY}}
- {{LOCALDAY2}}
- {{LOCALDOW}}
- {{LOCALDAYNAME}}
- {{LOCALTIME}}
- {{LOCALHOUR}}
- {{LOCALWEEK}}
- {{LOCALTIMESTAMP}}
Технические метаданные
Следующие переменные возвращают значения, связанные с последней правкой текущей статьи, независимо от просматриваемой версии.
Переменная | Возвращаемое значение | Описание | Версия |
---|---|---|---|
Сайт | |||
{{SITENAME}} | ЖД cправочник | Имя сайта ($wgSitename) | |
{{SERVER}} | http://xn--b1amah.xn--d1ad.xn--p1ai | URL домена($wgServer) | |
{{SERVERNAME}} | xn--b1amah.xn--d1ad.xn--p1ai | доменное имя ($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}} | /w | относительный путь к скрипту ($wgScriptPath) | |
{{CURRENTVERSION}} | 1.23.17 | Версия MediaWiki, на которой работает вики-проект. | 1.7+ |
{{CONTENTLANGUAGE}} | ru | Язык интерфейса по умолчанию ($wgLanguageCode) | 1.7+ |
Последняя правка статьи | |||
{{REVISIONID}} | 1515 | Уникальный идентификатор правки | |
{{REVISIONDAY}} | 7 | День совершения правки (без ведущего нуля) | |
{{REVISIONDAY2}} | 07 | День совершения правки (с ведущим нулём) | |
{{REVISIONMONTH}} | 07 | Месяц совершения правки (без ведущего нуля) | |
{{REVISIONYEAR}} | 2011 | Год совершения правки | |
{{REVISIONTIMESTAMP}} | 20110707085120 | Дата совершения правки в формате ISO 8601 | |
{{PAGESIZE:page name}}< | 37 074 | Возвращает размер указанной страницы в байтах. | 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}}
= 1403 и {{NUMBEROFPAGES:R}}
= 1403). Для волшебных слов, требующих параметра, таких как PAGESINCATEGORY, используйте «|R» (например, {{PAGESINCATEGORY:Help}}
и {{PAGESINCATEGORY:Help|R}}
).
Переменная | Возвращаемое значение | Описание | Версия |
---|---|---|---|
По вики-проекту в целом | |||
{{NUMBEROFPAGES}} | 1403 | Количество вики-страниц | 1.7+ |
{{NUMBEROFARTICLES}} | 126 | Количество страниц в основном пространстве | |
{{NUMBEROFFILES}} | 562 | Количество загруженных файлов | 1.5+ |
{{NUMBEROFEDITS}} | 2075 | Общее количество правок. | 1.10+ |
{{NUMBEROFUSERS}} | 5 | Количество зарегистрированных участников. | 1.7+ |
{{NUMBEROFADMINS}} | 1 | Количество участников, входящих в группу sysop. См. права участников. | 1.7+ |
{{NUMBERINGROUP:groupname}} | 2 ({{NUMBERINGROUP:bureaucrat}}, число бюрократов) |
Число пользователей определённой группы. | 1.14+ |
По пространствам имён | |||
{{PAGESINNS:2}} |
отключено | Количество страниц в заданном пространстве имён (замените 2 на ID нужного пространства имён). Запрещено по умолчанию, разрешается через $wgAllowSlowParserFunctions. | 1.7+ |
Разное | |||
{{PAGESINCATEGORY:Help}} | 44 | Количество страниц в заданной категории (замените «Help» на имя нужной категории). | 1.13+ |
{{PAGESINCAT:Help}} | 44 | Алиас для {{PAGESINCATEGORY}} .
|
1.13+ |
{{PAGESIZE:Help:Magic_words}} | 37 074 | Возвращает размер в байтах заданной страницы. | 1.13+ |
Названия страниц
Переменная | Возвращаемое значение | Описание | Версия |
---|---|---|---|
{{FULLPAGENAME}} | Справка:Magic words/ru | Пространство статей и название страницы | |
{{BASEPAGENAME}} | Magic words | Название страницы без текущей подстраницы и без указания пространства статей («Статья» на «Статья/test») | |
{{PAGENAME}} | Magic words/ru | Название страницы | 1.7+ |
{{SUBPAGENAME}} | ru | Название подстраницы («test» на «Страница/test») | 1.6+ |
{{SUBJECTPAGENAME}} | Справка:Magic words/ru | Название основной страницы статьи. | 1.7+ |
{{TALKPAGENAME}} | Обсуждение справки:Magic words/ru | Название страницы обсуждения статьи | 1.7+ |
Также есть эквиваленты для использования в ссылках на MediaWiki сайты, т.е. со знаками подчёркивания вместо пробелов и с URL-кодированием некоторых символов:
- {{FULLPAGENAMEE}}
- {{PAGENAMEE}}
- {{BASEPAGENAMEE}}
- {{SUBPAGENAMEE}}
- {{SUBJECTPAGENAMEE}}
- {{TALKPAGENAMEE}}
Начиная с версии 1.15+, все эти переменные могут принимать параметр, позволяющий указать название страницы, отличающейся от текущей:
- {{PAGENAME:Template:Main Page}} → Main Page
Пространство имён
Переменная | Возвращаемое значение | Описание |
---|---|---|
{{NAMESPACE}} | Справка | Пространство имён (название) |
{{SUBJECTSPACE}} | Справка | Пространство имён для текущей статьи |
{{TALKSPACE}} | Обсуждение справки | Пространство имён для текущей страницы обсуждения |
Эквиваленты с URL-кодированием:
- {{NAMESPACEE}}
- {{SUBJECTSPACEE}}
- {{TALKSPACEE}}
Функции парсера
Ссылки
Переменная | Возвращаемое значение | Описание | Версия |
---|---|---|---|
{{localurl:pagename}} {{localurl:pagename|query}} |
/wiki/Pagename /w/index.php?title=Pagename&query |
Относительный путь к странице | |
{{fullurl:pagename}} {{fullurl:pagename|query}} |
http://xn--b1amah.xn--d1ad.xn--p1ai/wiki/Pagename http://xn--b1amah.xn--d1ad.xn--p1ai/w/index.php?title=Pagename&query |
полная ссылка на страницу | |
{{filepath:file name}} {{filepath:file name|nowiki}} |
http://xn--b1amah.xn--d1ad.xn--p1ai/w/images/b/bc/Wiki.png http://xn--b1amah.xn--d1ad.xn--p1ai/w/images/b/bc/Wiki.png |
Полная ссылка на файл (есть ошибки с использованием nowiki) | r25854 |
{{urlencode:x y z}} | x+y+z
|
Кодирование для URL-адреса. | 1.7+ |
{{anchorencode:x y z}} | x_y_z
|
Кодирование URL после символа '#' (якорей). | 1.8+ |
Пространство имён
{{ns:}}
возвращает локализованное название пространства имён для указанного числа или константы. {{nse:}} возвращает то же самое, но в формате URL-адреса MediaWiki, где пробелы заменены символом подчёркивания, что позволяет использовать их во внешних ссылках.
Значения по умолчанию:
Содержательные пространства имён | Пространства имён обсуждений | |||
---|---|---|---|---|
Использование | Возвращаемое значение | Использование | Возвращаемое значение | |
{{ns:-2}} или {{ns:Media}} | Медиа | |||
{{ns:-1}} или {{ns:Special}} | Служебная | |||
{{ns:0}} или {{ns:}} | {{ns:1}} или {{ns:Talk}} | Обсуждение | ||
{{ns:2}} или {{ns:User}} | Участник | {{ns:3}} или {{ns:User_talk}} | Обсуждение участника | |
{{ns:4}} или {{ns:Project}} | ЖД cправочник | {{ns:5}} или {{ns:Project_talk}} | Обсуждение ЖД cправочник | |
{{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:en}} {{#language:ru}} {{#language:th}} |
English русский ไทย |
Имя языка по языковому коду на собственном языке в соответствии с ISO 639. | 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+ |
{{gender:username|мужчина|женщина|не установлено.}} | (в зависимости от тэга username) | Возвращает соответственно мужчина, женщина или не установлено для выбранного пользователя username в соответствии с его настройками в Special:Preferences | 1.15+ |
Собственные переменные
MediaWiki позволяет создавать новые переменные, как часть расширения или отдельной инсталляции. Подробную информацию см. в Manual:Variable.
Язык: | English • русский |
---|