Help:Magic words/ru

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

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


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


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


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

Переменные и функции парсера могут использоваться с подстановкой через 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.

Пространство имён
возвращает локализованное название пространства имён для указанного числа, канонического имени или локального псевдонима.   возвращает то же самое, но в формате URL-адреса MediaWiki, где пробелы заменены символом подчёркивания, что позволяет использовать их во внешних ссылках. Таким образом, все эти варианты —,  , и   (старое имя пространства имён файлов) — вернут «    ». В вики, где в качестве языка содержания выбран французский,  также будет корректным, а вот   (немецкая локализация названия "File") — нет.

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.

Форматирование
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, ,. 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.