Материал из ЖД cправочник
< Справка:Magic words(перенаправлено с «Справка:Variables/ru»)
Перейти к: навигация, поиск
PD Внимание: Когда вы редактируете эту страницу, вы соглашаетесь на передачу вашего вклада в общественное достояние. Если вы не хотите или не можете этого сделать из-за лицензионных ограничений, то, пожалуйста, не редактируйте. Эта страница является одной из страниц справки в общественном достоянии, которые могут свободно копироваться во вновь создаваемые вики-проекты и/или распространяться с ПО MediaWiki; см. содержание справки со списком всех страниц. Инструкции по копированию справки в ваш вики-проект — на странице Project:PD help/Copying/ru. PD

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

Существуют три основных типа «волшебных слов»:

Странично-зависимые волшебные слова принимают или возвращают данные о текущей странице (по умолчанию), даже если слово добавляется через раскрываемый шаблон или включённое в текст системное сообщение.

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

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

Выражение Описание Версия
Содержание
__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 (&lrm; on left-to-right wikis, &rlm; 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}}
{{PAGESINNAMESPACE: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-символ направления текста, согласно локализации (&lrm; и &rlm;, для текста слева-направо и справа-налево, соответственно). Используется для текста с несколькими направлениями. 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  • русский