Help:Magic words/ru

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

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


 * Переключатели поведения: это обычно слова, написанные большими буквами, обрамлённые двойным подчеркиванием, например,  .
 * Переменные: это заглавные буквы в двойных фигурных скобках, например,  . В сущности, они очень похожи на шаблоны.
 * Функции парсера: они могут принимать параметры, и имеют вид   или  , например . Смотрите также и.

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

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

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

Если имя шаблона совпадает с переменной, то вызывается переменная (так что для раскрытия шаблона    :PAGENAME вам придётся написать $codePAGENAME$code-end). В некоторых случаях добавление параметров может вызвать подключение шаблона; например, $tpl-currentdayname-code приведёт к включению шаблона $tpl-currentdayname-result, а не значения одноимённой переменной. In some cases, adding parameters will force the parser to invoke a template; for example,  transcludes     :CURRENTDAYNAME, not the variable.

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

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

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

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

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



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

Статистика
Числа, возвращаемые этими переменными, содержат разделители разрядов (запятая, точка или пробел, в зависимости от языка локализации). Для получения неотформатированных чисел используется флаг «:R» (например,  &rarr;  и   &rarr; ).

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

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

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

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

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



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



Заметьте, что,   и   реализованы по-разному. Подробнее смотрите в.

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



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

Параметр не должен совпадать с названием пространства имён:
 * &rarr; 
 * &rarr;  (Pages in main space will return empty)
 * &rarr; 
 * &rarr; 
 * &rarr; 
 * &rarr; 
 * &rarr;   (Empty)

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

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

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

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

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

Форматирование
Смотрите также:

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

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

Модификаторы включения
обычно включает другую страницу, по умолчанию из Template:namespace. Эти волшебные слова меняют это поведение.

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