Справка:Волшебные слова
 |
Внимание: Когда вы редактируете эту страницу, вы соглашаетесь на передачу своего вклада по лицензии CC0. Узнать об этом подробнее можно на странице справки.
|
|
«Волшебные слова» в MediaWiki — комбинации текста, управляющие поведением, оформлением той или иной страницы в вики, а также выводящие некоторые полезные переменные из базы данных. Более подробную информацию см. в Руководство:Волшебные слова.
Существуют три основных типа «волшебных слов»:
- Переключатели поведения: это обычно слова, написанные большими буквами, обрамлённые двойным подчеркиванием, например,
__FOO__. - Переменные: это заглавные буквы в двойных фигурных скобках, например,
{{FOO}}. В сущности, они очень похожи на шаблоны. - Функции парсера: они могут принимать параметры, и имеют вид
{{foo:...}}или{{#foo:...}}, например{{#invoke:}}. См. также Справка:Расширение:Функции Парсера и Расширение:Scribunto.
Переменные и функции парсера могут использоваться с подстановкой через subst:, так же, как и шаблоны. Странично-зависимые волшебные слова изменяют или возвращают данные о текущей странице (по умолчанию), даже если слово добавляется через раскрываемый шаблон или включённое в текст системное сообщение.
Переключатели поведения
Переключатели поведения, влияющие на оформление и поведение страниц (если поддерживаются темой оформления) и часто используются для того, чтобы скрыть или показать некоторый элемент страницы. Обратите внимание, что некоторые из них не поддерживаются в теме оформления Минерва.
| Слово | Описание | Версия | ||
|---|---|---|---|---|
| Содержание | ||||
__NOTOC__
|
Скрывает содержание страницы (table of contents, TOC). | |||
__FORCETOC__
|
Заставляет оглавление появиться в обычном месте — перед первым заголовком (отменяет действие __NOTOC__).
|
|||
__TOC__
|
Помещает оглавление в текущую позицию (отменяет действие __NOTOC__). Если используется в нескольких местах, то оглавление будет отображено только в первом из них.
|
|||
| Редактирование | ||||
__NOEDITSECTION__
|
Скрывает ссылки «править» для каждой секции страницы. Это особенно полезно, когда заголовок создается из шаблона: нормальный вики-инструмент редактирования разделов в этом случае изменял бы код шаблона, что, как правило, выглядит для пользователя противоестественно. Использование этого шаблона вызовет изменения в самом шаблоне, на всех страницах, в которые он вставлен, и всех остальных шаблонах, вставленных на той же странице. Другой способ смотрите здесь. | |||
__NEWSECTIONLINK__
|
Добавляет ссылку рядом со вкладкой «Править», которая добавляет новый раздел на любых страницах, кроме страниц обсуждений (смотрите добавление раздела в конец страницы). |
| ||
__NONEWSECTIONLINK__
|
Удаляет ссылку около вкладки «Править» на страницах в пространстве «Обсуждение» |
| ||
| Категории | ||||
__NOGALLERY__
|
Используется на страницах категорий. При просмотре категории заменяет изображения на обычные ссылки. |
| ||
__HIDDENCAT__
|
Используется на странице категории и позволяет скрыть эту категорию и нижеследующие из более старших категорий (в которые включена данная категория) (есть параметры в настройках пользователя для отображения их). |
| ||
__EXPECTUNUSEDCATEGORY__
|
Используется на странице категории. Удаляет эту категорию из Special:UnusedCategories. |
| ||
| Преобразование языков | ||||
__NOCONTENTCONVERT__ __NOCC__
|
Запрещает выполнение любой языковой конвертации содержания статьи. Например, будет отображён только китайский (zh), вместо таких вариантов, как zh_cn, zh_tw, zh_sg, или zh_hk. | |||
__NOTITLECONVERT__ __NOTC__
|
Запрещает выполнение языковой конвертации заголовка на сайтах с языковыми вариантами (прочее содержание будет проходить конверсию). | |||
| Другие | ||||
__START__
|
Ничего не делает Использовался для указания где начинается сообщение базы данных после комментария, которое не должно быть включено в другие страницы (transcluding). Удалено в r1695 и полностью удалено в r24784 |
| ||
__END__
|
Обозначает конец страницы, не давая MediaWiki удалить конечные пробелы. Удалено в 19213. |
| ||
__INDEX__
|
Позволяет поисковым системам индексировать страницу (переписывает $wgArticleRobotPolicies, но не robots.txt). Подчиняется переменной $wgExemptFromUserRobotsControl. |
| ||
__NOINDEX__
|
Запрещает индексацию страницы поисковыми системами (страница не будет отображена в результатах поиска). Подчиняется переменной $wgExemptFromUserRobotsControl. |
| ||
__STATICREDIRECT__
|
Помещённая на страницу с перенаправлением, запрещает MediaWiki автоматически обновлять ссылку в случае, когда кто-то, переименовывая страницу, поставил флажок «Исправить перенаправления, указывающие на прежнее название» (для чего требуется $wgFixDoubleRedirects). |
| ||
| Из расширений | ||||
| Расширение | Слово | Описание | Версии | |
| GlobalUserPage | __NOGLOBAL__
|
Отключает глобальную страницу пользователя. Если присутствует на центральной странице пользователя, то на других вики отображаться не будет, а также определяет, каким цветом будет показана ссылка на страницу пользователя в другой wiki - красным или синим. |
| |
| Disambiguator | __DISAMBIG__
|
Обозначает страницы решения неоднозначностей. |
| |
Переменные
Переменные возвращают сведения о текущей странице, вики-проекте или дате. Синтаксис большинства из них похож на синтаксис шаблонов. Переменные, помеченные как "[Затратная функция]", отслеживаются движком, и возможное число их включений на одной странице ограничено.
Если имя шаблона совпадает с переменной, то вызывается переменная (так что для раскрытия шаблона Template:PAGENAME вам придётся написать {{Template:PAGENAME}}). В некоторых случаях добавление параметров может вызвать подключение шаблона; например, {{CURRENTDAYNAME|x}} приведёт к включению шаблона Template:CURRENTDAYNAME, а не значения одноимённой переменной.
Дата и время
Следующие переменные возвращают текущую дату и время в UTC.
Вследствие кэширования страниц браузером и MediaWiki, эти переменные часто показывают когда страница была закэширована, вместо отображения текущего времени.
The use of those variables cause pages to be cached for a more limited number of seconds. This is configured in MagicWordFactory.
Значения переменных даты и времени форматируются в зависимости от языковых настроек вики. Начиная с версии 1.19, они зависят от настройки языка конкретной страницы.
| Переменная | Результат | Описание | Версия | |
|---|---|---|---|---|
| Год | ||||
{{CURRENTYEAR}}
|
2020 | Год | ||
| Месяц | ||||
{{CURRENTMONTH}}
|
10 | Месяц (номер с дополнением нулями до двузначного числа) | ||
{{CURRENTMONTH1}}
|
10 | Месяц (обычный порядковый номер) | ||
{{CURRENTMONTHNAME}}
|
октябрь | Месяц (название) | ||
{{CURRENTMONTHNAMEGEN}}
|
октября | Месяц (в родительном падеже) | ||
{{CURRENTMONTHABBREV}}
|
окт | Месяц (аббревиатура) |
| |
| День | ||||
{{CURRENTDAY}}
|
27 | День совершения правки (без ведущего нуля) | ||
{{CURRENTDAY2}}
|
27 | День месяца (с ведущим нулём: 01..31) |
| |
{{CURRENTDOW}}
|
2 | День недели (число). От 0 (воскресенье) до 6 (суббота). | ||
{{CURRENTDAYNAME}}
|
вторник | День недели (название) | ||
| Время | ||||
{{CURRENTTIME}}
|
21:43 | Время (24-часовой формат — HH:mm) | ||
{{CURRENTHOUR}}
|
21 | Час (01..24) | ||
| Разное | ||||
{{CURRENTWEEK}}
|
44 | Неделя (число) | ||
{{CURRENTTIMESTAMP}}
|
20201027214337 | Отметка времени в формате YYYYMMDDHHmmss |
| |
Следующие переменные возвращают значения, аналогичные вышеперечисленным, но используют настройки сервера или значение параметра $wgLocaltimezone.
{{LOCALYEAR}}{{LOCALMONTH}}{{LOCALMONTH1}}{{LOCALMONTHNAME}}{{LOCALMONTHNAMEGEN}}{{LOCALMONTHABBREV}}{{LOCALDAY}}{{LOCALDAY2}}{{LOCALDOW}}{{LOCALDAYNAME}}{{LOCALTIME}}{{LOCALHOUR}}{{LOCALWEEK}}{{LOCALTIMESTAMP}}
Для более тщательного форматирования времени, или чтобы вывести неделю и год в соответствии c ISO-8601, вам может захотеться установить Расширение:ParserFunctions, позволяющее использовать функцию парсера #time.
Технические метаданные
| Функция | Результат | Описание | Версия | ||
|---|---|---|---|---|---|
| Сайт | |||||
{{SITENAME}}
|
MediaWiki | Имя сайта ($wgSitename) | |||
{{SERVER}}
|
//www.mediawiki.org | URL-адрес домена ($wgServer) | |||
{{SERVERNAME}}
|
www.mediawiki.org | Поддомен или доменное имя (начиная с версии 1.17 больше не зависит от $wgServerName) | |||
{{DIRMARK}}
|
|
Выводит маркер направления Юникода, соответствующий направлению языка вики-проекта по умолчанию (‎ на сайтах с письменностью слева направо, ‏ — с письменностью справа налево); полезен в текстах с переменным направлением письма. Начиная с версии 1.19, зависит от языка конкретной страницы.
|
| ||
{{SCRIPTPATH}}
|
/w | Относительный путь к скрипту ($wgScriptPath). | |||
{{STYLEPATH}}
|
/w/skins | Относительный путь к стилю ($wgStylePath). |
| ||
{{CURRENTVERSION}}
|
1.36.0-wmf.14 (820bf42) | Версия MediaWiki, на которой работает вики-проект. |
| ||
{{CONTENTLANGUAGE}}
|
en en |
Язык интерфейса по умолчанию ($wgLanguageCode). |
| ||
| Страница | |||||
{{PAGEID}}
|
13403 | Возвращает идентификатор страницы. |
| ||
{{PAGELANGUAGE}}
|
ru
русский |
Возвращает язык текущей страницы. Код языка из этой переменной можно преобразовать в его название с помощью {{#language:...}}.
|
| ||
<translate><!--T:1--> Translated unit. Language: <tvar|lang>{{TRANSLATIONLANGUAGE}}</>.</translate>
|
Translated unit. Language: en.
Not translated unit. Language: en. |
Must be used in a translated page, inside <translate> tags. Returns the language code of the current translation unit. In a translation page, if the unit has been translated, then it returns translation language. Else, it returns source language. The language code that this variable returns can be converted to a language name using {{#language:...}}. Should only be used by translation admins.
|
| ||
{{PROTECTIONLEVEL:действие}}
|
Возвращает уровень защиты ('autoconfirmed', 'sysop') для заданного переменной действия ('edit', 'move') на текущей странице или пустую строку, если защита не установлена. |
| |||
{{PROTECTIONEXPIRY:действие}}
|
Выводит время окончания защиты (напр. "20160418155030", "infinity") для данного действия (напр. "edit", "move") на текущей странице. Возвращает "infinity", если защиты нет. |
| |||
{{CASCADINGSOURCES}}
|
[Затратная функция] Возвращает источники любой действующей на данную страницу каскадной защиты. Собственное название страницы не возвращают, если только не включают сами себя. |
| |||
| Последняя правка статьи | |||||
{{REVISIONID}}
|
- | Уникальный идентификатор правки It is empty in preview, thus one can show an error message only in preview. May be disabled in miser mode. |
| ||
{{REVISIONDAY}}
|
11 | День совершения правки (без ведущего нуля) |
| ||
{{REVISIONDAY2}}
|
11 | День совершения правки (с ведущим нулём) |
| ||
{{REVISIONMONTH}}
|
10 | Месяц совершения правки (с ведущим нулём начиная с версии 1.17+, предыдущие без нуля). |
| ||
{{REVISIONMONTH1}}
|
10 | Месяц совершения правки (без ведущего нуля) |
| ||
{{REVISIONYEAR}}
|
2020 | Год совершения правки |
| ||
{{REVISIONTIMESTAMP}}
|
20201011213309 | Временная метка совершения правки. |
| ||
{{REVISIONUSER}}
|
FuzzyBot | Имя пользователя, сделавшего последнюю правку на странице или пользователя, который на данный момент осуществляет предпросмотр редактированной странице. |
| ||
{{REVISIONSIZE}}
|
97629 | Размер (в байтах викитекста) текущей версии страницы |
| ||
| Воздействуют на содержимое страницы | |||||
{{DISPLAYTITLE:заголовок}} {{DISPLAYTITLE:заголовок|noerror}} {{DISPLAYTITLE:заголовок|noreplace}}
|
Позволяет изменять верхний заголовок текущей страницы. Значение должно быть эквивалентно заголовку по умолчанию, можно только изменять произвольно заглавные буквы некоторых частей заголовка (не всех) и заменять пробелы подчёркиваниями (это поведение можно изменить с помощью $wgRestrictDisplayTitle). Это поведение можно включать и отключать путём изменения значения переменной $wgAllowDisplayTitle; она была отключена до версии 1.10+ и включена во всех последующих версиях.
Может принимать второй параметр со значениями noerror или noreplace, чтобы подавлять сообщение об ошибке, когда на странице используется несколько DISPLAYTITLE или чтобы |
(для noerror и noreplace) | |||
{{DEFAULTSORT:ключ}} {{DEFAULTSORTKEY:ключ}} {{DEFAULTCATEGORYSORT:ключ}} {{DEFAULTSORT:ключ|noerror}} {{DEFAULTSORT:ключ|noreplace}}
|
Устанавливает ключ сортировки страницы во всех её категориях по умолчанию. Например, если поставить $sortSmith, John$sort-end в конце страницы John Smith, страница по умолчанию в категориях будет отсортировываться в разделе на букву «S». Может быть передан второй аргумент noerror или noreplace для подавления сообщений об ошибках, если даны несколько ключей по умолчанию на одной странице, или чтобы ключ $sort2 не учитывался, если уже есть $sort3 уже определен ранее на странице. For example if you put {{DEFAULTSORT:Smith, John}} at the end of John Smith, the page would be sorted under "S" by default in categories. It can take a second argument of noerror or noreplace to suppress error messages when multiple defaultsortkeys are used on one page or to make this defaultsort do nothing if a defaultsort was already specified earlier in the page.
|
((для noerror и noreplace)) | |||
Статистика
Числа, возвращаемые этими переменными, содержат разделители разрядов (запятая, точка или пробел, в зависимости от языка локализации). Для получения неотформатированных чисел используется флаг «:R» (например, {{NUMBEROFPAGES}} → 1 001 043 и {{NUMBEROFPAGES:R}} → 1001043).
Для волшебных слов, требующих параметра, таких как PAGESINCATEGORY, используйте «|R» (например, {{PAGESINCATEGORY:Help}} и {{PAGESINCATEGORY:Help|R}}, или {{PAGESINCATEGORY:Help|subcats}} и {{PAGESINCATEGORY:Help|subcats|R}}). Это также применимо к вышеописанному {{PAGESIZE:название страницы}}.
Числовые значения переменных форматируются в зависимости от языковых настроек вики. Начиная с версии 1.19, они зависят от настройки языка конкретной страницы.
| Переменная | Результат | Описание | Версия | |
|---|---|---|---|---|
{{NUMBEROFPAGES}}
|
1 001 043 | Количество вики-страниц. |
| |
{{NUMBEROFARTICLES}}
|
43 291 | Количество страниц в основном пространстве, соответствующих критериям статьи. Смотрите Manual:$wgArticleCountMethod для более подробной информации. | ||
{{NUMBEROFFILES}}
|
3177 | Количество загруженных файлов. |
| |
{{NUMBEROFEDITS}}
|
4 096 397 | Общее количество правок. |
| |
{{NUMBEROFVIEWS}}
|
Общее количество просмотров страниц. Обычно бесполезно для вики, использующих кеширование. Убрано в Gerrit change 150699. |
| ||
{{NUMBEROFUSERS}}
|
17 388 849 | Количество зарегистрированных пользователей. |
| |
{{NUMBEROFADMINS}}
|
218 | Количество пользователей в группе sysop. |
| |
{{NUMBEROFACTIVEUSERS}}
|
1307 | Количество активных пользователей, на основании критериев, используемых в Special:Statistics. |
| |
{{PAGESINCATEGORY:categoryname}} {{PAGESINCAT:categoryname}}
|
124 124 |
[Затратная функция] Число страниц (включая все подкатегории и файлы) в заданной категории. Для примера использована категория Category:Help. |
| |
{{PAGESINCATEGORY:категория|all}} {{PAGESINCATEGORY:категория|pages}} {{PAGESINCATEGORY:категория|subcats}} {{PAGESINCATEGORY:категория|files}}
|
124 120 4 0 |
[Затратная функция] Соответственно, количество
в заданной категории. Для примера исользована категория Category:Help. |
| |
{{NUMBERINGROUP:группа}} {{NUMINGROUP:группа}}
|
35 35 |
Число пользователей определённой группы. ({{NUMBERINGROUP:bureaucrat}} используется для демонстрации) |
| |
{{PAGESINNS:индекс}} {{PAGESINNAMESPACE:индекс}}
|
отключено | [Затратная функция] Количество страниц в заданном пространстве имён (замените номер на ID нужного пространства имён). For instance, {{PAGESINNAMESPACE:14}} will output the number of category pages. {{PAGESINNS:0}} differs from {{NUMBEROFARTICLES}} in that the former includes redirects and disambiguation pages. Disabled by default, enable with $wgAllowSlowParserFunctions.
|
|
Названия страниц
| Переменная | Для текущей страницы | Описание | Версия | |
|---|---|---|---|---|
{{FULLPAGENAME}}
|
Help:Magic words/ru | Пространство имён и название страницы (включая все уровни подстраниц). |
| |
{{PAGENAME}}
|
Magic words/ru | Полное название страницы (включая все уровни подстраниц) без пространства имён. | ||
{{BASEPAGENAME}}
|
Magic words | Название страницы без предыдущей подстраницы и без указания пространства имён. Would return Title/Foo on page Help:Title/Foo/Bar.
|
| |
{{ROOTPAGENAME}}
|
Magic words | Имя страницы, корневой к данной. Возвращает Title со страницы Help:Title/Foo/Bar
|
| |
{{SUBPAGENAME}}
|
ru | Название подстраницы. Would return If no subpage exists the value of Для более сложного разделения, используйте функцию |
| |
{{SUBJECTPAGENAME}} {{ARTICLEPAGENAME}}
|
Help:Magic words/ru Help:Magic words/ru |
Полное название страницы для ассоциированных с ней субъектов (например, статья или файл). Используется на страницах обсуждения. |
| |
{{TALKPAGENAME}}
|
Help talk:Magic words/ru | Полное название страницы ассоциированной страницы обсуждения. |
|
None of these are affected by changes to the display title using {{DISPLAYTITLE:xxxx}}; the values returned are the original page title.
«Волшебные слова» {{BASEPAGENAME}} и {{SUBPAGENAME}} работают только для пространств имён, в которых включены подстраницы. См. $wgNamespacesWithSubpages, чтобы узнать о включении подстраниц.
Начиная с версии 1.15+, все эти переменные могут принимать параметр, позволяющий указать название страницы, а не только текущую страницу:
{{PAGENAME:Template:Main Page}}→ Main Page
 Внимание: | Если заголовок содержит любые части, равные "." или "..", волшебное слово не сможет ничего вернуть.
|
| Внимание: | Заголовки страниц, содержащие некоторые символы, среди которых одинарная кавычка ' и звёздочка *, могут при обработке данными конструкциями выдавать неожиданные результаты, как, например, {{PAGESINCATEGORY:{{PAGENAME}}}}. Смотрите сообщения об ошибках T16779, T18474, T37628, T37746. Одним из простых путей исправления этого может быть помещение имени страницы внутрь {{#titleparts:}} из расширения ParserFunctions. |
URL-кодирование названий страниц
Также есть эквиваленты для использования в URL-адресах страниц MediaWiki (со знаками подчёркивания вместо пробелов и с URL-кодированием некоторых символов или заменой на числовые коды HTML):
{{FULLPAGENAMEE}}{{PAGENAMEE}}{{BASEPAGENAMEE}}{{SUBPAGENAMEE}}{{SUBJECTPAGENAMEE}}{{ARTICLEPAGENAMEE}}{{TALKPAGENAMEE}}{{ROOTPAGENAMEE}}
Заметьте, что {{PAGENAME:...}}, {{PAGENAMEE:...}} и {{urlencode:...}} реализованы по-разному. Подробнее смотрите в Manual:PAGENAMEE encoding.
Пространство имён
| Переменная | Результат | Описание | Версии | |
|---|---|---|---|---|
{{NAMESPACE}}
|
Help | Пространство имён (название) | ||
{{NAMESPACENUMBER}}
|
12 | ID пространства имён страницы |
| |
{{SUBJECTSPACE}} {{ARTICLESPACE}}
|
Help Help |
Пространство имён для текущей страницы |
| |
{{TALKSPACE}}
|
Help talk | Пространство имён для текущей страницы обсуждения |
|
Эквиваленты с URL-кодированием (со знаками подчёркивания вместо пробелов и с URL-кодированием некоторых символов):
{{NAMESPACEE}}{{SUBJECTSPACEE}}{{ARTICLESPACEE}}{{TALKSPACEE}}
Начиная с версии 1.15+, эти функции могут в качестве параметра принимать полное имя любой страницы и возвращать пространства имён для неё:
{{NAMESPACENUMBER:MediaWiki}}→ 0{{NAMESPACE:MediaWiki}}→ (Pages in main space will return empty){{NAMESPACE:Template:Main Page}}→ Template{{SUBJECTSPACE:Template:Main Page}}→ Template{{ARTICLESPACE:Template:Main Page}}→ Template{{TALKSPACE:Template:Main Page}}→ Template talk
Параметр не должен совпадать с названием пространства имён:
{{SUBJECTSPACE:Help talk}}→ (Empty)
Разное
| Переменная | Результат | Описание | Версии | |
|---|---|---|---|---|
{{!}}
|
| | " в качестве аргумента шаблона или содержания ячейки таблицы. Ранее для этих же целей использовался шаблон !, заменяемый на |.
|
|
Функции парсера
Функции парсера очень похожи на переменные, но принимают один или более аргументов (на самом деле любые магические слова, принимающие аргументы, являются функциями парсера). Имена функций парсера начинают с символа «#» (хеш), чтобы не путать их с шаблонами.
Далее перечислены функции парсера, предоставляемые движком MediaWiki. Функции парсера, добавляемые расширениями (такими, как расширение Расширение:ParserFunctions), приведены на отдельной странице: Справка:Расширение:Функции Парсера.
Технические метаданные о другой странице
| Функция парсера | Результат (для страницы MediaWiki) |
Описание | Версии | |
|---|---|---|---|---|
{{PAGEID: название страницы }}
|
1 | [Затратная функция] Возвращает идентификатор указанной страницы*. |
| |
{{PAGESIZE:название страницы}} {{PAGESIZE: название страницы |R}}
|
89 652 89652 |
[Затратная функция] Возвращает размер указанной страницы в байтах. Для получения «сырого» числа (никак не отформатированного) используйте кодовый параметр «|R».
|
| |
{{PROTECTIONLEVEL:действие | название страницы}}
|
sysop | [Затратная функция] Выводит уровень защиты (например, "autoconfirmed", "sysop"), установленный для заданного действия (например, "edit", "move") на указанной странице. Возвращает пустую строку, если защита отсутствует. |
| |
{{PROTECTIONEXPIRY:
|
infinity | [Затратная функция] Outputs the protection expiry (e.g. "20160418155030", "infinity") for a given action (e.g. "edit", "move") on the specified page. Возвращает "infinity", если защиты нет. |
| |
{{CASCADINGSOURCES: page name}}
|
[Затратная функция] Возвращает источники любой действующей на указанную страницу каскадной защиты. Собственное название страницы не возвращают, если только не включают сами себя. |
| ||
{{REVISIONID: название страницы }}
|
3878227 | [Затратная функция] Возвращает уникальный идентификатор последней версии указанной страницы*. |
| |
{{REVISIONDAY: название страницы }}
|
26 | [Затратная функция] День последней правки указанной страницы* (число от 1 до 31). |
| |
{{REVISIONDAY2: название страницы }}
|
26 | [Затратная функция] День последней правки указанной страницы* (число от 01 до 31). |
| |
{{REVISIONMONTH: название страницы }}
|
05 | [Затратная функция] Месяц последней проверенной правки указанной страницы* (с ведущим нулём начиная с версии 1.17+, предыдущие без нуля). |
| |
{{REVISIONMONTH1: название страницы }}
|
5 | [Затратная функция] Месяц последней правки указанной страницы* (число от 1 до 12). |
| |
{{REVISIONYEAR: название страницы }}
|
2020 | [Затратная функция] Год последней правки указанной страницы*. |
| |
{{REVISIONTIMESTAMP: название страницы }}
|
20200526133817 | [Затратная функция] Время последней правки указанной страницы*. |
| |
{{REVISIONUSER: название страницы }}
|
Shirayuki | [Затратная функция] Имя пользователя, совершившего последнюю правку указанной страницы*. |
| |
*Поведение функции парсера меняется, если значение аргумента ссылается на текущую страницу.
| ||||
Получение фрагментов URL
| Функция парсера | Конструкция → Результат | Описание | Версии | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
{{localurl:название страницы}} {{localurl:название страницы
|
{{localurl:MediaWiki}}→ /wiki/MediaWiki {{localurl:MediaWiki|printable=yes}}→ /w/index.php?title=MediaWiki&printable=yes |
Относительный путь к странице. | |||||||||||||||
{{fullurl:название страницы}} {{fullurl:название страницы {{fullurl:interwiki:remote page name
|
{{fullurl:Category:Top level}}→ //www.mediawiki.org/wiki/Category:Top_level
|
Полная ссылка на страницу, зависимая от используемого протокола, который зависит от $wgServer на локальной вики (и поэтому может или не может начинаться с http(s)://). Здесь также допустимы интервики-префиксы. Замечание: не ограниченные квадратными скобками (простые) ссылки, зависимые от протокола, не станут активными автоматически.
|
| ||||||||||||||
{{canonicalurl:название страницы}} {{canonicalurl:название страницы {{canonicalurl:interwiki:remote page name
|
{{canonicalurl:Category:Top level}}→ https://www.mediawiki.org/wiki/Category:Top_level
|
Абсолютный путь к заглавию, использующий канонический URL. Также разрешает префиксы интервики. |
| ||||||||||||||
{{filepath:название файла}} {{filepath:название файла|nowiki}} {{filepath:название файла|thumbnail_size}}
|
{{filepath:Wiki.png}}→ //upload.wikimedia.org/wikipedia/mediawiki/b/bc/Wiki.png
|
Полная путь к файл или миниатюре (1.18+) файла. |
| ||||||||||||||
{{urlencode:строка}} или {{urlencode:строка|QUERY}} {{urlencode:строка|WIKI}} {{urlencode:строка|PATH}}
|
{{urlencode:x:y/z á é}} or {{urlencode:x:y/z á é|QUERY}}→ x%3Ay%2Fz+%C3%A1+%C3%A9 {{urlencode:x:y/z á é|WIKI}}→ x:y/z_%C3%A1_%C3%A9 {{urlencode:x:y/z á é|PATH}}→ x%3Ay%2Fz%20%C3%A1%20%C3%A9 Обратите внимание, что с версии 1.17 значение по умолчанию изменилось в |
Замена символов, запрещённых к использованию в URL, на %-последовательности (например, пробел будет заменён на %20). Обратите внимание, что выполняющая обратное действие функция urldecode (аналогичная существующей в расширении Extension:StringFunctions) пока не реализована..
|
| ||||||||||||||
{{anchorencode:строка}}
|
{{anchorencode:x y z á é}}→ x_y_z_á_é |
Преобразовать аргумент в вид, пригодный к использованию в URL после символа '#' (якоря) |
| ||||||||||||||
Пространства имён
Конструкция {{ns:}} заменяется на название пространства имён на текущем языке, оглавление, каноническое имя или псевдоним.
Конструкции {{ns:6}}, {{ns:File}} и {{ns:Image}} (старое имя для File namespace) заменяются на "File". На страницах французской википедии конструкция {{ns:Fichier}} будет считаться корректной, а конструкция {{ns:Datei}} (переведённое на немецкий язык слово "File") — нет.
Действие {{nse:}} аналогично действию функции urlencode с одним отличием: пробелы заменяются на символы "_". Это используется во внешних ссылках.
| Пространства имён для статей | Пространства имён для страниц обсуждений | |||
|---|---|---|---|---|
| Использование | Результат | Использование | Возвращаемое значение | |
{{ns:-2}} / {{ns:Media}}
|
Media | {{ns:-1}} / {{ns:Special}}
|
Special (no talk page) | |
{{ns:0}} / {{ns:}}
|
{{ns:1}} / {{ns:Talk}}
|
Talk | ||
{{ns:2}} / {{ns:User}}
|
User | {{ns:3}} / {{ns:User talk}}
|
User talk | |
{{ns:4}} / {{ns:Project}}
|
Project Varies between wikis |
{{ns:5}} / {{ns:Project talk}}
|
Project talk | |
{{ns:6}} / {{ns:File}} or {{ns:Image}}
|
File | {{ns:7}} / {{ns:File talk}} or {{ns:Image talk}}
|
File talk | |
{{ns:8}} / {{ns:MediaWiki}}
|
MediaWiki | {{ns:9}} / {{ns:MediaWiki talk}}
|
MediaWiki talk | |
{{ns:10}} / {{ns:Template}}
|
Template | {{ns:11}} / {{ns:Template talk}}
|
Template talk | |
{{ns:12}} / {{ns:Help}}
|
Help | {{ns:13}} / {{ns:Help talk}}
|
Help talk | |
{{ns:14}} / {{ns:Category}}
|
Category | {{ns:15}} / {{ns:Category talk}}
|
Category talk | |
Не путайте переведённые на ваш язык пространства имён с настраиваемыми пространствами имён.
Форматирование
| Функция | Конструкция → Результат | Описание | Версия | ||||||
|---|---|---|---|---|---|---|---|---|---|
{{formatnum:unformatted number}}
|
Неподдерживаемое: В следующих примерах указаны неправильные аргументы с или без использования |
Берёт неформатированное число (арабские цифры без разделителей групп разрядов и с точкой в качестве десятичного разделителя) и выводит его в локализованном наборе цифр, отформатированным с десятичным разделителем и разделителями групп согласно текущей локали вики. Для обратного действия можно использовать параметр
Если вам очень нужно отформатировать (по текущей вики) число в неизвестном входном формате, можете попробовать использовать |
| ||||||
|
|
|
Форматирует несвязанную дату на основе пользовательского предпочтения «формат даты» и добавляет метаданные, помечая ее как отформатированную дату. Для пользователей, вышедших из системы, а также тех, кто не установил формат даты в своих предпочтениях, датам может быть присвоено значение по умолчанию: mdy, dmy, ymd, ISO 8601 (с учётом регистра). Если формат не указан или является недопустимым, используется формат по умолчанию. Если предоставленная дата не распознается как действительная дата (в частности, если она содержит какие-либо метаданные, например, от вложенного использования этих или аналогичных шаблонов), она отображается без изменений и никакие (дополнительные) метаданные не создаются.
|
| ||||||
{{lc:string}}
|
{{lc:DATA CENTER}} → data center
|
Строка в нижнем регистре. |
| ||||||
{{lcfirst:string}}
|
{{lcfirst:DATA center}} → dATA center
|
Строка с первым символом в нижнем регистре. |
| ||||||
{{uc:string}}
|
{{uc:text transform}} → TEXT TRANSFORM
|
Строка в верхнем регистре. |
| ||||||
{{ucfirst:string}}
|
{{ucfirst:text tRAnSFORM}} → Text tRAnSFORM
|
Строка с первым символом в верхнем регистре. |
| ||||||
{{padleft:xyz|stringlength}}
|
{{padleft:xyz|5}} → 00xyz
|
Ввод (первый параметр) дополняется с левой стороны до указанной ширины (второй параметр) с использованием базовых символов (третий параметр). Последние цифры или базовые символы заменяют последние цифры; т.е. {{padleft:44|3|0}} создает 044. Заполняющая строка может быть обрезана, если ее длина не делит равномерно необходимое количество символов.
В версиях до 1.12 использовался только первый символ третьего параметра, но начиная с версии 1.15 используются все символы. Ошибка (исправлено в r45734): — мультибайтовые символы интерпретируются как два символа, что может исказить ширину. Они также не могут использоваться в качестве отступов. |
| ||||||
{{padright:xyz|stringlength}} {{padright:xyz|strlen|char}} {{padright:xyz|strlen|string}}
|
{{padright:xyz|5}} → xyz00
|
Аналогично padleft, но добавляет отступ с правой стороны.
|
|
См. также: Extension:StringFunctions
Локализация
Здесь приведены волшебные слова, используемые как основные инструменты локализации. Прочие волшебные слова часто зависят от местной вики и настроек или от выбранного языка: см. в частности #Дата и время, #Форматирование, #Прочее. Расширение:Перевод добавило больше волшебных слов.
Использование этих волшебных слов может быть очень сложным, а документация неполной; больше сведений на PLURAL, GRAMMAR, GENDER.
| Использование | Конструкция → Результат | Описание | Версия | |
|---|---|---|---|---|
{{plural:2|is|are}}
|
{{plural:0|is|are}} → are{{plural:1*1|is|are}} → is{{plural:21 mod 10|is|are}} → is{{plural:{{#expr:21 mod 10}}|is|are}} → is{{plural:1|is|are}} → is{{plural:2|is|are}} → are{{plural:-1|is|are}} → is{{plural:-2|is|are}} → are{{plural:0.5|is|are}} → are{{plural:1.5|is|are}} → are{{plural:-0.5|is|are}} → are{{plural:-1.5|is|are}} → areДля Русского языка {{PLURAL:5|1=Категория|Категории}} → Категории
|
Выводит форму множественного числа (второй параметр) в зависимости от числа в первом параметре; в противном случае множественное число (третий параметр). Его функционирование зависит от языка.
Some language codes (ab, av, ba, bxr, ce, crh_cyrl, cv, inh, koi, krc, kv, lbe, lez, mhr, mrj, myv, ru, tt_cyrl, tyv, udm, xal) used 3 plural forms (updated 01.2014):
|
||
{{grammar:N|noun}}
|
Выводит заданное слово в правильной грамматической форме (склонении, падеже), согласно коду, указанному после двоеточия (зависит от языка). Грамматическая трансформация используется в таких языках как польский. Смотрите также $wgGrammarForms. |
| ||
{{gender:username|text for every gender}}
|
(Зависит от указанного пола пользователя) | Переключатель настройки пола в персональных настройках. Замечание: первый пример ничего не делает. |
| |
{{int:название сообщения}}
|
{{int:edit}} → Edit (Зависит от языка пользователя; попробуйте: fr • ja) |
Переводит данное интерфейсное (interface) сообщение (пространство имён MediaWiki) на язык пользователя. По поводу msgnw и других волшебных слов — см. раздел о модификаторах шаблонов.
Обратите внимание, это может повредить/перепутать ссылки кэша в MediaWiki 1.17 и более ранних версиях, см. T16404. |
||
{{int:editsectionhint|MediaWiki}}
|
{{int:editsectionhint|MediaWiki}} → Edit section: MediaWiki
|
Вы также можете использовать параметры с переводом. Параметры обозначены $1, $2, $3 и т.д. Например, вот сообщение для editsectionhint: Edit section: $1 В этом примере MediaWiki заменяет $1. |
Модификаторы включения
{{Page name|optional params}} обычно включает другую страницу, по умолчанию из Template:namespace.
Эти волшебные слова меняют это поведение.
| Использование | Результат | Описание | Версия | |
|---|---|---|---|---|
{{:xyz}}
|
В данном случае двоеточие не является модификатором шаблона, но является приставкой для обозначения основного пространства имен. Поскольку включение по умолчанию использует пространство Шаблон, Вы должны использовать {{:UTC}} (вместо {{UTC}}) для включения текста статьи UTC из основного пространства вместо включения Шаблон:UTC. | |||
{{int:xyz}}
|
То же, что и {{MediaWiki:xyz}}, кроме того, что стандартное сообщение зависит от подстраниц и языка содержимого/пользователя/uselang. Еще одно различие состоит в том, что это не показывается в "Шаблоны, используемые на этой странице:". Показывается как ⧼xyz⧽, если MediaWiki:xyz не существует. См. также Help:Системные сообщения. | |||
{{msg:xyz}}{{raw:xyz}}
|
Даже если есть волшебное слово с именем «xyz», используйте Шаблон:xyz, если шаблон не существует (эквивалент {{template:xyz}}). Обычно магические слова имеют приоритет при возникновении конфликта. | |||
{{raw:xyz}}
|
Если $wgEnableScaryTranscluding включен, и это является включением между интервики, то вставляет необработанный вики-текст вместо html из иностранной вики. |
| ||
{{msgnw:xyz}}
|
Показывается нераскрытый викитекст (более или менее, подробнее: Help:Template#Usage). | |||
{{subst:xyz}}
|
В викитексте тег заменяется на «контент» (только одноуровневая оценка), см. Help:Template#Usage. | |||
{{safesubst:xyz}}
|
Смотрите Help:Template#Usage. |
Прочее
| Использование | Результат | Описание | Версия | |||
|---|---|---|---|---|---|---|
{{#language:код языка}}{{#language:ar}} {{#language:код языка| {{#language:ar|en}}
|
language code العربية language code Arabic |
Полное имя языка для заданного кода языка: собственное имя по умолчанию, имя переводится на целевой язык, если указан код целевого языка. Extension:CLDR должен быть установлен для работы перевода. |
| |||
{{#special:название служебной страницы}}
|
Special:Special page name Special:UserLogin |
Локализованное имя для служебных страниц. |
| |||
{{#speciale:название служебной страницы}}
|
Special:Special_page_name Special:UserLogin |
Локализованное и URL-кодированное имя от канонического имени служебной страницы. |
| |||
{{#tag:tagname
|
(зависит от тэга парсера) | Псевдоним для тегов парсера MediaWiki в стиле XML или тегов расширения. Он позволяет предварительное сохранение преобразования кода вики и Расширение:ParserFunctions в тегах до обработки тега. Это также предотвращает синтаксический анализ тегов в условных путях, которые не выполняются (например, в операторах #if). Содержимое между тегами передается как первый параметр, а любые атрибуты тегов могут быть переданы как последующие параметры. Этот пример:
…может быть переписан следующим образом:
Пример для тега
|
|