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

Ссылки сюда (1) →

Шаблон:PD Help Page/ru «Волшебные слова» в MediaWiki — комбинации текста, управляющие поведением, оформлением той или иной страницы в вики, а также выводящие некоторые полезные переменные из базы данных. Более подробную техническую информацию см. в Manual: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}}	22	День месяца (1..31)
{{CURRENTDAY2}}	22	День месяца (с ведущим нулём: 01..31)	1.6+
{{CURRENTDOW}}	5	День недели (число)
{{CURRENTDAYNAME}}	пятница	День недели (название)
Время
{{CURRENTTIME}}	19:38	Текущее время (24-часовой формат — HH:mm)
{{CURRENTHOUR}}	19	Час (01..24)
Разное
{{CURRENTWEEK}}	47	Текущая неделя (число)
{{CURRENTTIMESTAMP}}	20241122193854	Время по стандарту 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}}	622	Уникальный идентификатор правки
{{REVISIONDAY}}	22	День совершения правки (без ведущего нуля)
{{REVISIONDAY2}}	22	День совершения правки (с ведущим нулём)
{{REVISIONMONTH}}	07	Месяц совершения правки (без ведущего нуля)
{{REVISIONYEAR}}	2009	Год совершения правки
{{REVISIONTIMESTAMP}}	20090722194330	Дата совершения правки в формате 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}} = 2360 и {{NUMBEROFPAGES:R}} = 2360). Для волшебных слов, требующих параметра, таких как PAGESINCATEGORY, используйте «|R» (например, {{PAGESINCATEGORY:Help}} и {{PAGESINCATEGORY:Help|R}}).

Переменная	Возвращаемое значение	Описание	Версия
По вики-проекту в целом
{{NUMBEROFPAGES}}	2360	Количество вики-страниц	1.7+
{{NUMBEROFARTICLES}}	249	Количество страниц в основном пространстве
{{NUMBEROFFILES}}	1277	Количество загруженных файлов	1.5+
{{NUMBEROFEDITS}}	15 115	Общее количество правок.	1.10+
{{NUMBEROFUSERS}}	1934	Количество зарегистрированных участников.	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.

Languages

Language:

English