Help:Magic words/ru

Внимание: Когда вы редактируете эту страницу, вы соглашаетесь на передачу вашего вклада в общественное достояние. Если вы не хотите или не можете этого сделать из-за лицензионных ограничений, то, пожалуйста, не редактируйте. Эта страница является одной из страниц справки в общественном достоянии, которые могут свободно копироваться во вновь создаваемые вики-проекты и/или распространяться с ПО MediaWiki; см. содержание справки со списком всех страниц. Инструкции по копированию справки в ваш вики-проект — на странице Project:PD help/Copying/ru.

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

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

• Переключатели поведения: это заглавные буквы, обрамлённые двойным подчеркиванием, например, __FOO__
• Переменные: это заглавные буквы в двойных скобках, например, {{FOO}}. Как таковые, они очень похожи на шаблоны.
• Функции парсера: эти параметры могут принимать любой вид, будь то {{foo:...}} или {{#foo:...}}. См. также Help:Extension:ParserFunctions.

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

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

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

Выражение	Описание	Версия
Содержание
__NOTOC__	Скрывает оглавление страницы (TOC).
__FORCETOC__	Заставляет содержание подниматься выше определённого уровня (в нулевой секции).
__TOC__	Размещает оглавление в текущую позицию (противоположно «слову» __ NOTOC __). Если используется _TOC_, то оглавление вернётся в исходное место на странице.
Редактирование
__NOEDITSECTION__	Скрывает ссылки «править» для каждой секции страницы.
__NEWSECTIONLINK__	Добавляет кнопку («+» по умолчанию) рядом с кнопкой «править» на любых страницах (см. m:Help:Section#Adding a section at the end).	1.7+
__NONEWSECTIONLINK__	Удаляет кнопку («+» по умолчанию) рядом с кнопкой «править» на страницах в пространствах «Обсуждение»	1.15+
Категории
__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}}	2012	Год
Текущий месяц
{{CURRENTMONTH}}	02	Месяц (число)
{{CURRENTMONTHNAME}}	February	Текущий месяц (название)
{{CURRENTMONTHNAMEGEN}}	February	Текущий месяц (в родительном падеже)
{{CURRENTMONTHABBREV}}	Feb	Текущий месяц (аббревиатура)	1.5+
День
{{CURRENTDAY}}	4	День месяца (1..31)
{{CURRENTDAY2}}	04	День месяца (с ведущим нулём: 01..31)	1.6+
{{CURRENTDOW}}	6	День недели (число)
{{CURRENTDAYNAME}}	Saturday	День недели (название)
Время
{{CURRENTTIME}}	03:22	Текущее время (24-часовой формат — HH:mm)
{{CURRENTHOUR}}	03	Час (01..24)
Разное
{{CURRENTWEEK}}	5	Текущая неделя (число)
{{CURRENTTIMESTAMP}}	20120204032208	Время по стандарту ISO 8601	1.7+

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

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

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

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

Функция	Возвращаемое значение	Описание	Версия
Сайт
{{SITENAME}}	MediaWiki	Имя сайта ($wgSitename)
{{SERVER}}	//www.mediawiki.org	URL домена ($wgServer)
{{SERVERNAME}}	www.mediawiki.org	доменное имя ($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.18wmf1 (r109351)	Версия MediaWiki, на которой работает вики-проект.	1.7+
{{CONTENTLANGUAGE}}	en	Язык интерфейса по умолчанию ($wgLanguageCode)	1.7+
Последняя правка статьи
{{REVISIONID}}	487237	Уникальный идентификатор правки
{{REVISIONDAY}}	18	День совершения правки (без ведущего нуля)
{{REVISIONDAY2}}	18	День совершения правки (с ведущим нулём)
{{REVISIONMONTH}}	01	Месяц совершения правки (без ведущего нуля)
{{REVISIONYEAR}}	2012	Год совершения правки
{{REVISIONTIMESTAMP}}	20120118202338	Дата совершения правки в формате ISO 8601
{{REVISIONUSER}}	Alogrin	Имя участника, сделавшего последнюю правку на странице или участника, который предварительно просматривает страницу перед записью в данный момент	1.15+
{{PAGESIZE:page name}} {{PAGESIZE:page name|R}}	41,910 41910	Возвращает размер указанной страницы в байтах с разделителем без параметра и в виде «сырого» числа (количество байт без разделителя, пригодное для арифметических вычислений) с параметром R.	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}} = 51,131 и {{NUMBEROFPAGES:R}} = 51131). Для волшебных слов, требующих параметра, таких как PAGESINCATEGORY, используйте «|R» (например, {{PAGESINCATEGORY:Help}} и {{PAGESINCATEGORY:Help|R}}).

Функция	Возвращаемое значение	Описание	Версия
По вики-проекту в целом
{{NUMBEROFPAGES}}	51,131	Количество вики-страниц.	1.7+
{{NUMBEROFARTICLES}}	8,635	Количество страниц в основном пространстве.
{{NUMBEROFFILES}}	1,516	Количество загруженных файлов.	1.5+
{{NUMBEROFEDITS}}	519,456	Общее количество правок.	1.10+
{{NUMBEROFUSERS}}	476,839	Количество зарегистрированных участников.	1.7+
{{NUMBEROFADMINS}}	93	Количество участников, входящих в группу sysop. См. права участников.	1.7+
{{NUMBERINGROUP:groupname}}	22 ({{NUMBERINGROUP:bureaucrat}}, число бюрократов)	Число пользователей определённой группы.	1.14+
По пространствам имён
{{PAGESINNS:2}} {{PAGESINNAMESPACE:2}}	отключено	Количество страниц в заданном пространстве имён (замените 2 на ID нужного пространства имён). Запрещено по умолчанию, разрешается через $wgAllowSlowParserFunctions.	1.7+
Разное
{{PAGESINCATEGORY:Help}}	70	Количество страниц в заданной категории (замените «Help» на имя нужной категории).	1.13+
{{PAGESINCAT:Help}}	70	Алиас для {{PAGESINCATEGORY}}.	1.13+
{{PAGESIZE:Help:Magic_words}}	41,910	Возвращает размер в байтах заданной страницы.	1.13+

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

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

Также есть эквиваленты для использования в ссылках на MediaWiki сайты, т.е. со знаками подчёркивания вместо пробелов и с URL-кодированием некоторых символов:

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

Начиная с версии 1.15+, все эти переменные могут принимать параметр, позволяющий указать название страницы, отличающейся от текущей:

• {{PAGENAME:Template:Main Page}} → Main Page

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

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

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

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

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

Ссылки

Функция	Возвращаемое значение	Описание	Версия
{{localurl:pagename}} {{localurl:pagename|query}}	/wiki/Pagename /w/index.php?title=Pagename&query	Относительный путь к странице
{{fullurl:pagename}} {{fullurl:pagename|query}}	//www.mediawiki.org/wiki/Pagename //www.mediawiki.org/w/index.php?title=Pagename&query	Полная ссылка на страницу
{{filepath:file name}} {{filepath:file name|nowiki}}	//upload.wikimedia.org/wikipedia/mediawiki/b/bc/Wiki.png //upload.wikimedia.org/wikipedia/mediawiki/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}}	Media
{{ns:-1}} или {{ns:Special}}	Special
{{ns:0}} или {{ns:}}			{{ns:1}} или {{ns:Talk}}	Talk
{{ns:2}} или {{ns:User}}	User		{{ns:3}} или {{ns:User_talk}}	User talk
{{ns:4}} или {{ns:Project}}	Project		{{ns:5}} или {{ns:Project_talk}}	Project talk
{{ns:6}} или {{ns:Image}}	File		{{ns:7}} или {{ns:Image_talk}}	File talk
{{ns:8}} или {{ns:MediaWiki}}	MediaWiki		{{ns:9}} или {{ns:MediaWiki_talk}}	MediaWiki talk
{{ns:10}} или {{ns:Template}}	Template		{{ns:11}} или {{ns:Template_talk}}	Template talk
{{ns:12}} или {{ns:Help}}	Help		{{ns:13}} или {{ns:Help_talk}}	Help talk
{{ns:14}} или {{ns:Category}}	Category		{{ns:15}} или {{ns:Category_talk}}	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. В ряде языковых версий Википедии (русская, белорусская, польская) эта функция настроена так, что позволяет использовать 3 параметра, а для определения формы слова используется остаток от деления на 100. В результате не только {{plural:1|слово|слова|слов}}=слово и {{plural:2|слово|слова|слов}}=слова , но и {{plural:5|слово|слова|слов}}=слов На http://www.mediawiki.org 3-й параметр функции «plural» не работает, так что {{plural:5|слово|слова|слов}}=слова

Прочее

Функция	Возвращаемое значение	Описание	Версия
{{#language:en}} {{#language:ru}} {{#language:th}}	English Русский ไทย	Имя языка по языковому коду на собственном языке в соответствии с ISO 639.	1.7+
{{#special:userlogin}}	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.