Help:Magic words/ru

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

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


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

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



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

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

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



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

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

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

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

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



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



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

Используйте "|R" для волшебных слов, для которых требуется параметр типа PAGESINCATEGORY (например, $pic и $pic-r или $pic-subcats и $pic-subcats-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. Функции парсера, добавляемые расширениями (такими, как расширение ), приведены на отдельной странице:.



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


Пространства имён
Конструкция  заменяется на название пространства имён на текущем языке, оглавление, каноническое имя или псевдоним. Конструкции 6,  -file и  -img (старое имя для File namespace) заменяются на "    ". На страницах французской википедии конструкция -file-de будет считаться корректной, а конструкция  -file-incorrect (переведённое на немецкий язык слово "File") — нет. Поэтому,   и   (старое название для пространства имён File) возвращают "    ". On a wiki where the content language is French,  is also valid, but   (the localisation of "File" in German) is not.

The main namespace has no name, i.e.  returns an empty string. For explicitly referring to the main namespace,  can be used, resulting in "".

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

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

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

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

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



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

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