Help:Magic words/ru

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

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


 * Behavior switches: these are uppercase words surrounded by double underscores, e.g. __FOO__.


 * Variables: these are uppercase words surrounded by double braces, e.g.  . As such, they look a lot like templates.


 * Parser functions: these take parameters and are either of the form   or  . See also.

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

Переключатели поведения
Переключатели поведения — «волшебные слова», влияющие на оформление страниц в вики.

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

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

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

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

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

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

Для более тщательной форматирования времени вам может захотеться установить расширение функций парсера, позволяющее использовать функцию парсера #time.

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

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

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

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

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

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

Например, для страницы с названием "L'Aquila" следующий код отобразит "Numeric char encoding":

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



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

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



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

Параметр не должен совпадать с названием пространства имён:
 * &rarr; 
 * &rarr; 
 * &rarr; 
 * &rarr;   (Empty)

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

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

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

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

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

Форматирование
See also: Extension:StringFunctions.

Локализация
Here are the magic words which are used as main localisation tools. Other magic words will often depend on the wiki's locale and configuration or on the chosen language: see in particular #Date and time, #Formatting, #Miscellaneous. More magic words are added by the Translate extension.

The usage of these magic words can be very complex, and the documentation is currently incomplete; there's some more info on PLURAL, GRAMMAR, GENDER.