Array

Примечание: Когда вы редактируете эту страницу, вы соглашаетесь на передачу своего вклада по лицензии CC0. Чтобы узнать подробности, обратитесь к проекту Помощь с общественным достоянием. Translate

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

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

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

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

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

Переключатели поведения, влияющие на оформление и поведение страниц (если поддерживаются темой оформления) и часто используются для того, чтобы скрыть или показать некоторый элемент страницы. Обратите внимание, что некоторые из них не поддерживаются в теме оформления Минерва.

Переменные

Переменные возвращают сведения о текущей странице, вики-проекте или дате. Синтаксис большинства из них похож на синтаксис шаблонов. Переменные, помеченные как "[Затратная функция]", отслеживаются движком, и возможное число их включений на одной странице ограничено.

Если имя шаблона совпадает с переменной, то вызывается переменная (так что для раскрытия шаблона Template:PAGENAME вам придётся написать {{Template:PAGENAME}}). В некоторых случаях добавление параметров может вызвать подключение шаблона; например, {{CURRENTDAYNAME|x}} приведёт к включению шаблона Template:CURRENTDAYNAME, а не значения одноимённой переменной.

Дата и время

Следующие переменные возвращают текущую дату и время в UTC.

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

Использование этих переменных приводит к кэшированию страниц на более ограниченное количество секунд. Это настраивается в MagicWordFactory.

Значения переменных даты и времени форматируются в зависимости от языковых настроек вики. Начиная с версии 1.19, они зависят от настройки языка конкретной страницы.

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

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

Для более тщательного форматирования времени, или чтобы вывести неделю и год в соответствии c ISO-8601, вам может захотеться установить Расширение:ParserFunctions , позволяющее использовать функцию парсера #time .

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

Статистика

Числа, возвращаемые этими переменными, содержат разделители разрядов (запятая, точка или пробел, в зависимости от языка локализации). Для получения неотформатированных чисел используется флаг «:R» (например, {{NUMBEROFPAGES}} → 1 256 453 и {{NUMBEROFPAGES:R}} → 1256453).

Для волшебных слов, требующих параметра, таких как PAGESINCATEGORY, используйте «|R» (например, {{PAGESINCATEGORY:Help}} и {{PAGESINCATEGORY:Help|R}}, или {{PAGESINCATEGORY:Help|subcats}} и {{PAGESINCATEGORY:Help|subcats|R}}). Это также применимо к вышеописанному {{PAGESIZE:название страницы}}.

Числовые значения переменных форматируются в зависимости от языковых настроек вики. Начиная с версии 1.19, они зависят от настройки языка конкретной страницы.

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

Ни на одно из них не влияют изменения отображаемого заголовка с помощью {{DISPLAYTITLE:xxxx}} ; возвращаемые значения являются исходным заголовком страницы.

«Волшебные слова» {{BASEPAGENAME}} и {{SUBPAGENAME}} работают только для пространств имён, в которых включены подстраницы. См. $manual-wg-ns-with-subpages, чтобы узнать о включении подстраниц.

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

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

Внимание:

Если заголовок содержит любые части, равные «.» или «..», волшебное слово ничего не возвращает. {{PAGENAME:one/./three}} → . Ничего не возвращается.

Внимание:

Заголовки страниц, содержащие некоторые символы, среди которых одинарная кавычка ' и звёздочка *, могут при обработке данными конструкциями выдавать неожиданные результаты, как, например, {{PAGESINCATEGORY:{{PAGENAME}}}}. Смотрите сообщения об ошибках T16779, T18474, T37628, T37746. Одним из простых путей исправления этого может быть помещение имени страницы внутрь {{#titleparts:}} из расширения ParserFunctions.

URL-кодирование названий страниц

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

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

Заметьте, что {{PAGENAME:...}}, {{PAGENAMEE:...}} и {{urlencode:...}} реализованы по-разному. Подробнее смотрите в Manual:PAGENAMEE encoding .

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

Эквиваленты с URL-кодированием (со знаками подчёркивания вместо пробелов и с URL-кодированием некоторых символов):

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

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

• {{NAMESPACENUMBER:MediaWiki}} → 0
• {{NAMESPACE:MediaWiki}} → (Pages in main space will return empty)
• {{NAMESPACE:Template:Main Page}} → Template
• {{SUBJECTSPACE:Template:Main Page}} → Template
• {{ARTICLESPACE:Template:Main Page}} → Template
• {{TALKSPACE:Template:Main Page}} → Template talk

Параметр не должен совпадать с названием пространства имён:

• {{SUBJECTSPACE:Help talk}} →   (Empty)

Разное

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

Функции парсера очень похожи на переменные, но принимают один или более аргументов (на самом деле любые магические слова, принимающие аргументы, являются функциями парсера). Имена функций парсера начинают с символа «#» (хеш), чтобы не путать их с шаблонами.

Далее перечислены функции парсера, предоставляемые движком MediaWiki. Функции парсера, добавляемые расширениями (такими, как расширение Расширение:ParserFunctions ), приведены на отдельной странице: Справка:Расширение:Функции Парсера .

Технические метаданные о другой странице

Получение фрагментов URL

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

Конструкция {{ns:}} заменяется на название пространства имён на текущем языке, оглавление, каноническое имя или псевдоним. Конструкции {{ns:6}}, {{ns:File}} и {{ns:Image}} (старое имя для File namespace) заменяются на "File". На страницах французской википедии конструкция {{ns:Fichier}} будет считаться корректной, а конструкция {{ns:Datei}} (переведённое на немецкий язык слово "File") — нет.

Действие {{nse:}} аналогично действию функции urlencode с одним отличием: пробелы заменяются на символы "_". Это используется во внешних ссылках.

Не путайте переведённые на ваш язык пространства имён с настраиваемыми пространствами имён.

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

Функция	Ввод → Результат	Описание	Версия
{{formatnum:unformatted number}} {{formatnum:formatnum-formatted number|R}} {{formatnum:unformatted number|NOSEP}}	Пример: {{formatnum:987654321.654321}} → 987 654 321,654321 {{formatnum:987 654 321,654321|R}} → 987654321.654321 Пример для опытных пользователей: {{formatnum:{{formatnum:987654321.654321}}|R}} → 987654321.654321 (для любого языка) {{formatnum:00001}} → 00 001 {{formatnum:987654321.654321 |NOSEP}} → 987654321.654321 Примеры перевода на бенгальский язык: {{formatnum:987654321.654321}} → ৯৮,৭৬,৫৪,৩২১.৬৫৪৩২১ {{formatnum:987654321.654321 |NOSEP}} → ৯৮৭৬৫৪৩২১.৬৫৪৩২১ {{formatnum:৯৮,৭৬,৫৪,৩২১.৬৫৪৩২১ |R}} → 987654321.654321 Неподдерживаемое: {{formatnum:{{formatnum:987.654.321}}}} → 987 654 321 (например, на итальянском языке) В следующих примерах указаны неправильные аргументы с или без использования |R: {{formatnum:987,654.321|R}} (наименее повреждённая) {{formatnum:987.654,321|R}} {{formatnum:987 654,321|R}} {{formatnum:987 654,321|R}}	Берёт неформатированное число (арабские цифры без разделителей групп разрядов и с точкой в качестве десятичного разделителя) и выводит его в локализованном наборе цифр, отформатированным с десятичным разделителем и разделителями групп согласно текущей локали вики. Для обратного действия можно использовать параметр |R, для использования в математических ситуациях: он надёжен и должен использоваться только для расформатирования чисел, которые заведомо отформатированы в точности так, как их форматирует formatnum по текущей вики. Параметр NOSEP ("no separators") означает, что никакие групповые и десятичные разделители не изменяются; formatnum преобразует только сами цифры для языков, которые не используют индо-арабскую систему цифр. NOSEP также может предотвратить нестандартную группировку цифр, которую вы не ожидаете. Внимание: Ведущие нули не удаляются, взамен можно использовать {{#expr:00001}}, если установлено Расширение:ParserFunctions . Внимание: Если вы не подаёте на вход числа в точности в требуемом формате, не ждите надёжного выхода, особенно для неанглийских вики. Если вам очень нужно отформатировать (по текущей вики) число в неизвестном входном формате, можете попробовать использовать formatnum два раза (но не тогда, когда у него может быть десятичная группа, иначе разделитель будет съеден, либо число не отформатируется). Отдавайте себе отчёт, что это скорее хак, чем обычный способ обработки, поэтому результат не может быть надёжным.	≥ 1.7 ≥ 1.13 r32012
{{#dateformat:date}} {{#formatdate:date}} {{#dateformat:date|format}} {{#formatdate:date|format}}	{{#dateformat:25 dec 2009|ymd}} → 25 dec 2009 (ваша настройка), 2009 Dec 25 (по умолчанию) {{#formatdate:dec 25,2009|dmy}} → dec 25,2009 (ваша настройка), 25 Dec 2009 (по умолчанию) {{#dateformat:2009-12-25|mdy}} → декабрь 25, 2009 (ваша настройка), December 25, 2009 (по умолчанию) {{#formatdate:2009 dec 25|ISO 8601}} → 2009 dec 25 (ваша настройка), 2009-12-25 (по умолчанию) {{#dateformat:25 decEmber|mdy}} → 25 decEmber (ваша настройка), DecEmber 25 (по умолчанию) Замечание: В приведённом выше примере «Ваш префикс» относится только к префиксу даты текущей MediaWiki.	Форматирует несвязанную дату на основе пользовательского предпочтения «формат даты» и добавляет метаданные, помечая ее как отформатированную дату. Для пользователей, вышедших из системы, а также тех, кто не установил формат даты в своих предпочтениях, датам может быть присвоено значение по умолчанию: mdy, dmy, ymd, ISO 8601 (с учётом регистра). Если формат не указан или является недопустимым, используется формат по умолчанию. Если предоставленная дата не распознается как действительная дата (в частности, если она содержит какие-либо метаданные, например, от вложенного использования этих или аналогичных шаблонов), она отображается без изменений и никакие (дополнительные) метаданные не создаются. Внимание: Хотя стандарт ISO 8601 требует дат по григорианскому календарю, параметр ISO в этой функции также отформатирует даты, выпадающие из стандартного григорианского диапазона (например, даты до 1583 г.). Также это волшебное слово не может правильно преобразовывать отрицательные годы (используемые по ISO 8601) и годы BC или BCE (используемые в обычной переписке).	≥ 1.15 r48249
{{lc:string}}	{{lc:DATA CENTER}} → data center	Строка в нижнем регистре.	≥ 1.5
{{lcfirst:string}}	{{lcfirst:DATA center}} → dATA center	Строка с первым символом в нижнем регистре.	≥ 1.5
{{uc:string}}	{{uc:text transform}} → TEXT TRANSFORM	Строка в верхнем регистре.	≥ 1.5
{{ucfirst:string}}	{{ucfirst:text tRAnSFORM}} → Text tRAnSFORM	Строка с первым символом в верхнем регистре.	≥ 1.5
{{padleft:xyz|stringlength}} {{padleft:xyz|strlen|char}} {{padleft:xyz|strlen|string}}	{{padleft:xyz|5}} → 00xyz {{padleft:xyz|5|_}} → __xyz {{padleft:xyz|5|abc}} → abxyz {{padleft:xyz|2}} → xyz {{padleft:|1|xyz}} → x (первый символ строки)	Ввод (первый параметр) дополняется с левой стороны до указанной ширины (второй параметр) с использованием базовых символов (третий параметр). Последние цифры или базовые символы заменяют последние цифры; т.е. {{padleft:44|3|0}} создает 044. Заполняющая строка может быть обрезана, если ее длина не делит равномерно необходимое количество символов. В версиях до 1.12 использовался только первый символ третьего параметра, но начиная с версии 1.15 используются все символы. Ошибка (исправлено в r45734): — мультибайтовые символы интерпретируются как два символа, что может исказить ширину. Они также не могут использоваться в качестве отступов.	≥ 1.8 ≥ 1.15 r45734
{{padright:xyz|stringlength}} {{padright:xyz|strlen|char}} {{padright:xyz|strlen|string}}	{{padright:xyz|5}} → xyz00 {{padright:xyz|5|_}} → xyz__ {{padright:xyz|5|abc}} → xyzab {{padright:xyz|2}} → xyz {{padright:|1|xyz}} → x	Аналогично padleft, но добавляет отступ с правой стороны.	≥ 1.8 ≥ 1.15 r45734

Смотрите также: Extension:StringFunctions

Локализация

Здесь приведены волшебные слова, используемые как основные инструменты локализации. Прочие волшебные слова часто зависят от местной вики и настроек или от выбранного языка: см. в частности #Дата и время, #Форматирование, #Прочее. Расширение:Translate добавило больше волшебных слов.

Использование этих волшебных слов может быть очень сложным, а документация неполной; больше сведений на PLURAL, GRAMMAR, GENDER.

Модификаторы включения

{{Page name|optional params}} обычно включает другую страницу, по умолчанию из Template:namespace. Эти волшебные слова меняют это поведение.

Прочее

Использование	Ввод → Результат	Описание	Версия
{{#language:код языка}} {{#language:код языка|код целевого языка}}	{{#language:ar}} → العربية {{#language:ar|en}} → Arabic	Полное имя языка для заданного кода языка: собственное имя по умолчанию, имя переводится на целевой язык, если указан код целевого языка. Extension:CLDR должен быть установлен для работы перевода.	≥ 1.7 r14490 ≥ 1.18 r91875 (перевод)
{{#special:название служебной страницы}}	{{#special:userlogin}} → Special:UserLogin	Локализованное имя для служебных страниц.	≥ 1.9 r17321
{{#speciale:название служебной страницы}}	{{#speciale:userlogin}} → Special:UserLogin	Локализованное и URL-кодированное имя от канонического имени служебной страницы.	≥ 1.20 Gerrit change 4340
{{#tag:имя тега |содержание |атрибут1=значение1 |атрибут2=значение2 }}	Пример для тега ‎<ref> из расширения Cite: {{#tag:ref|Цитирование на Magic words/ru. |name = "несколько"}} → [1]	Псевдоним для тегов парсера MediaWiki в стиле XML или тегов расширения. Он позволяет предварительное сохранение преобразования кода вики и Расширение:ParserFunctions в тегах до обработки тега. Это также предотвращает синтаксический анализ тегов в условных путях, которые не выполняются (например, в операторах #if). Содержимое между тегами передается как первый параметр, а любые атрибуты тегов могут быть переданы как последующие параметры. Этот пример: ‎<имя тега атрибут1="значение1" атрибут2="значение2">Ваш контент находится здесь‎</имя тега> …может быть переписан следующим образом: {{#tag:имя тега|Ваш контент находится здесь|атрибут1=значение1|атрибут2=значение2}} Внимание: Чтобы передать пустую строку, вы должны написать {{#tag:имя тега||атрибут1=значение1|атрибут2=значение2}}. В области, зарезервированной для содержания, не должно быть пробелов между вертикальными чертами (т. н. пайпами) ||, находящимися перед атрибутом1.	≥ 1.12 r29482

О функции парсера #invoke см. w:ru:Википедия:Модули