Help:Magic words/ru

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

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


 * Переключатели поведения: это обычно слова, написанные большими буквами, обрамлённые двойным подчеркиванием, например,  .


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


 * Функции парсера: они могут принимать параметры, и имеют вид   или  , например . См. также  и.

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

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

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

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

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

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

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

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



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

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

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

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

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

Названия страниц
None of these are affected by changes to the display title using ; the values returned are the original page title.

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

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

{{Warning|1=Заголовки страниц, содержащие некоторые символы, среди которых одинарная кавычка  и звёздочка , могут при обработке данными конструкциями выдавать неожиданные результаты, как, например,. Смотрите сообщения об ошибках T16779, T18474, T37628, T37746. Одним из простых путей исправления этого может быть помещение имени страницы внутрь  из расширения ParserFunctions.

Например, для страницы с названием "$pagename" следующий код отобразит "$result":

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



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

Пространство имён
Эквиваленты с 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. Эти волшебные слова меняют это поведение.