Help:Magic words/ru

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

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


 * Переключатели поведения: это заглавные буквы, обрамлённые двойным подчеркиванием, например, __FOO__


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


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

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

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

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

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

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

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

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

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

For more thorough time formatting, you may want to install Extension:ParserFunctions to use the #time parser function.

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

Statistics
Numbers returned by these variables normally contain separators (commas or spaces, depending on the local language), but can return raw numbers with the ":R" flag (for example,  &rarr;  and   &rarr; ).

Use "|R" for magic words that require a parameter like PAGESINCATEGORY (for example  and , or   and  ). Also applicable to  hereinbefore.

The number magic words are formatted in the wiki content language. Since, it depends on the page content language.

Page names
The  and   magic words only work in namespaces that have subpages enabled. See for information on enabling subpages.

As of, these can all take a parameter, allowing specification of the page to be operated on, instead of just the current page:
 * &rarr; 

For example, if page name is "L'Aquila", the following code will produce the string "Numeric char encoding":

URL encoded page names
The following are equivalents encoded for use in MediaWiki URLs (i.e. spaces replaced with underscores and some characters HTML escaped using numeric character encoding):



Note that,   and   have distinct implementations. See Manual:PAGENAMEE encoding for details.

Namespaces
The following are equivalents encoded for use in MediaWiki URLs (spaces replaced with underscores and some characters percent-encoded):



As of, these can take a full-page-name parameter and will return the requested namespace associated with that page, instead of with the current page:

Parameter must not be a namespace name:
 * &rarr; 
 * &rarr; 
 * &rarr; 
 * &rarr;   (Empty)

Parser functions
Parser functions are very similar to variables, but take one or more parameters (technically, any magic word that takes a parameter is a parser function), and the name is sometimes prefixed with a hash to distinguish them from templates.

This page only describes parser functions that are integral to the MediaWiki software. Other parser functions may be added by MediaWiki extensions such as the. For those see Help:Extension:ParserFunctions.

Namespaces
returns the current localized name for the namespace with that index, canonical name, or local alias. Thus,  , and   (an old name for the File namespace) all return "    ". On a wiki where the content language is French,  is also valid, but   (the localisation of "File" in German) is not.

is the equivalent encoded for MediaWiki URLs. It does the same, but it replaces spaces with underscores, making it usable in external links.

Don't confuse localised namespaces with custom namespaces.

Formatting
See also: Extension:StringFunctions.

Localisation
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, ,. 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.