Help:Magic words/ru

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

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


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

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



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

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

Если имя шаблона конфликтует с переменной, будет использоваться эта переменная (поэтому для транскрипции шаблона вам нужно будет написать ). В некоторых случаях добавление параметров заставит синтаксический анализатор вызывать шаблон; например,  включает     :CURRENTDAYNAME, а не переменную.



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

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

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

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

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



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



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

Используйте "|R" для волшебных слов, для которых требуется параметр типа PAGESINCATEGORY (например,  и   или   и  ). Также применимо к, указанному выше.

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



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

«Волшебные слова»  и   работают только для пространств имён, в которых включены подстраницы. См. $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. Функции парсера, добавляемые расширениями (такими, как расширение ), приведены на отдельной странице:.



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


Получение фрагментов URL
The following are equivalents encoded for use in MediaWiki URLs (some characters percent-encoded):







Пространства имён
Конструкция  заменяется на название пространства имён на текущем языке, оглавление, каноническое имя или псевдоним. Конструкции 6,  -file и  -img (старое имя для File namespace) заменяются на "    ". На страницах французской википедии конструкция -file-de будет считаться корректной, а конструкция  -file-incorrect (переведённое на немецкий язык слово "File") — нет. Поэтому,   и   (старое название для пространства имён File) возвращают "    ". В вики, где языком содержимого является французский  также допустимо, но   (локализация «File» на немецком языке) — нет.

Основное пространство имен не имеет имени, т. е.  возвращает пустую строку. Для явного обращения к основному пространству имен можно использовать, в результате чего получится "".

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

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

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

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

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



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

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