Помощь:Волшебные слова

Специальная разметка для MediaWiki

Волшебные слова (включая функции парсера , переменные и переключатели поведения ) — это функции вики-разметки , которые дают инструкции базовому программному обеспечению MediaWiki Википедии . Например, волшебные слова могут подавлять или позиционировать оглавление, отключать индексацию внешними поисковыми системами и динамически выводить данные на основе текущей страницы или на основе пользовательской условной логики. Некоторые из этих функций особенно полезны для шаблонов .

Эта страница — краткий справочник по магическим словам. Для получения дополнительной информации обратитесь к основной документации MediaWiki:

  • mw:Справка:Волшебные слова: Все стандартные магические слова, включая «стандартные» функции синтаксического анализатора.
  • mw:Help:Extension:ParserFunctions: Дополнительные функции синтаксического анализатора, включая условные выражения.

Общая информация

Вообще, существует три типа магических слов.

  1. Переключатели поведения : часто отображаются в двойном подчеркивании, все заглавные буквы, например, __NOTOC__. Они изменят поведение страницы, а не вернут значение.
  2. Функции парсера : все в нижнем регистре. За функцией парсера следуют параметры, разделенные двоеточием и вертикальной чертой, например, {{#ifexpr:Y|Yes|No}}, заключенные в двойные фигурные скобки. Они принимают значение и возвращают значение.
  3. Переменные : все они заглавные, например, {{PAGENAME}}. Переменная будет заключена в двойные скобки и вернет значение на своем месте.

Программное обеспечение обычно интерпретирует магические слова следующим образом:

  • Волшебные слова чувствительны к регистру .
  • Пробелы щедро разрешены для удобства чтения. Они будут удалены из начала и конца ключевых слов и параметров (как это также делается в вызовах шаблонов с использованием именованных параметров).
  • Они могут быть включены , даже переменные "о текущей странице". Это обеспечивается порядком разбора.
  • Вместо того чтобы волшебным образом преобразовываться в HTML-инструкции, теги устраняют эту магию, так что само волшебное слово может быть отображено (задокументировано), например, или .<nowiki><nowiki>{{#magic:}}</nowiki>{{#magic:<nowiki/>}}

Волшебные слова в сравнении с шаблонами:

  • Как и в случае с шаблонами, магические слова можно транслировать и заменять .
  • Имена магических слов намеренно выбираются непохожими на имена шаблонов, и наоборот. Многие имена функций парсера будут начинаться с #( решетки или хэша ), но имена шаблонов не будут начинаться с (решетки# ) и, вероятно, не будут заканчиваться на :(двоеточие) или будут полностью заглавными.
  • Синтаксис первого параметра отличается. В {{#magic: p1 | p2 | p3}}, имя — #magicи за ним следует неразделенный :и обязательный входной параметр, p1. С шаблоном p1является необязательным и ему предшествует |(вертикальная черта) вместо :, например {{template|p1}}.

Большинство волшебных слов можно использовать в любых нужных местах на странице; см. MOS:ORDER для получения рекомендаций о том, где размещать волшебные слова, являющиеся переключателями поведения.

Переключатели поведения

ВыключательОписание
__TOC__Размещает оглавление страницы (TOC) в позиции слова. Это волшебное слово не работает в скинах, которые представляют оглавление вне содержимого статьи, например, скин по умолчанию Vector 2022.
__FORCETOC__Заставляет TOC отображаться в своей позиции по умолчанию, даже если заголовков меньше четырех. Может использоваться в любом месте страницы. Это волшебное слово не работает в скинах, которые представляют оглавление вне содержимого статьи, например, скин по умолчанию Vector 2022.
__NOTOC__Подавляет появление оглавления страницы. Может использоваться в любом месте страницы.
__NOEDITSECTION__Скрывает ссылки «редактировать», обычно расположенные рядом со всеми заголовками на странице. Чтобы скрыть ссылку «редактировать» рядом с определенным заголовком, укажите заголовок, используя, например, HTML-тег, такой как , а не обычный синтаксис знаков равенства вики (например ).<h2>heading</h2>== heading == 
__ARCHIVEDTALK__Скрывает кнопку «Ответить»
__NEWSECTIONLINK__На страницах, не предназначенных для обсуждения, добавляет ссылку «Новый раздел» как средство добавления нового раздела на страницу.
__NONEWSECTIONLINK__Удаляет ссылку «Новый раздел» (ссылка добавления нового раздела) на страницах обсуждения.
__NOGALLERY__Заменяет миниатюры на странице категории обычными ссылками.
__HIDDENCAT__Делает категорию скрытой при добавлении на страницу этой категории.
__INDEX__Дает указание поисковым системам проиндексировать страницу.
__NOINDEX__Дает указание поисковым системам не индексировать страницу. См. Wikipedia:Управление индексацией поисковой системы .
__STATICREDIRECT__Предотвращает автоматическое обновление ссылки на странице перенаправления при перемещении страницы, на которую она перенаправляет (и выборе «Обновить все перенаправления, указывающие на исходный заголовок»).
__DISAMBIG__Отмечает страницу как страницу устранения неоднозначности , добавляет ее в Special:DisambiguationPages и размещает внутренние ссылки в Special:DisambiguationPageLinks . (См. mw:Extension:Disambiguator.)
{{DISPLAYTITLE:title}}Используется для изменения отображаемой формы заголовка страницы.
{{DEFAULTSORT:sortkey}}Устанавливает ключ по умолчанию (индекс), по которому категоризируется страница. Функциональность документирована в Help:Category § Default sort key , а рекомендации — в Wikipedia:Categorization § Sort keys .
{{NOEXTERNALLANGLINKS}}(эквивалентно {{NOEXTERNALLANGLINKS:*}}  ) Подавляет автоматическое включение межъязыковых ссылок Wikidata в левой части страницы. Ссылки на определенные, а не на все языки, могут быть подавлены с помощью {{NOEXTERNALLANGLINKS: list }}, где list — список языковых кодов, разделенных вертикальной чертой ( например, {{NOEXTERNALLANGLINKS:fr|es|ja}} для подавления межъязыковых ссылок на французском ("fr"), испанском ("es") и японском ("ja") языках).

Переменные

Ярлык
  • ВП:ВАР
Переменная имени страницыВыходОписание
{{FULLPAGENAME}}Помощь:Волшебные словаКаноническое имя страницы . Строка заголовка . Заголовок, если регистр букв не изменен на {{DISPLAYTITLE}}. [a]
{{PAGENAME}}Волшебные словаСтрока заголовка без учета пространства имен .
{{BASEPAGENAME}}Волшебные словаНазвание родительской страницы, без учета пространства имен.
{{ROOTPAGENAME}}Волшебные словаЗаголовок самого верхнего родителя (перед всеми подстраницами), исключая пространство имен.
{{SUBPAGENAME}}Волшебные словаНа подстранице, крайняя правая часть текущего заголовка; более высокие названия подстраниц отображаются как обратные ссылки .
{{ARTICLEPAGENAME}}Помощь:Волшебные словаНазвание страницы темы, связанной с текущей страницей. Они полезны на страницах обсуждения (но см. примечание о страницах обсуждения категории).
{{SUBJECTPAGENAME}}Помощь:Волшебные слова
{{TALKPAGENAME}}Помощь по разговору:Волшебные словаНазвание страницы обсуждения, связанной с текущей страницей. Полезно на тематических страницах.
{{NAMESPACENUMBER}}12Номер пространства имен текущей страницы.
{{NAMESPACE}}ПомощьПространство имен заголовка.
{{ARTICLESPACE}}ПомощьНа странице обсуждения — часть пространства имен заголовка соответствующей тематической страницы.
{{SUBJECTSPACE}}Помощь
{{TALKSPACE}}Помогите поговоритьПространство имен страницы обсуждения, связанной с текущей страницей.
{{FULLPAGENAMEE}},
{{PAGENAMEE}},
 (и т. д.)
Помощь:Волшебные_слова,
Волшебные_слова,
(и т.д.)
Добавление E в конец указанных выше переменных преобразует их в код, пригодный для использования в URL-адресах MediaWiki (т. е. с заменой пробелов подчеркиваниями).
{{SHORTDESC}}Работает только в английской Википедии, где на мобильных платформах отображается краткое описание под заголовком статьи. См. Wikipedia:Краткое описание .

информация Примечание: Волшебные слова выше также могут принимать параметр, чтобы анализировать значения на странице, отличной от текущей. :Для передачи параметра используется двоеточие ( ), а не вертикальная черта ( |), которая используется в шаблонах, например {{MAGICWORD:value}}. Например, {{TALKPAGENAME:Wikipedia:MOS}}возвращаетОбсуждение Википедии:MOSна любой странице.

 Внимание: Попытка использовать (некоторые) переменные имени страницы для создания викиссылки на страницу изображения, страницу категории или межъязыковую ссылку приведет к другому эффекту: это соответственно поместит изображение на страницу, добавит страницу в категорию или создаст межъязыковую ссылку на краю страницы. Чтобы переопределить это нормальное поведение, добавьте к переменной префикс в виде двоеточия ( :); например [[:{>{FULLPAGENAME}}]].

Более подробную информацию о функциях синтаксического анализатора, относящихся к именам страниц и пространствам имен, см. в разделе meta:Help:Имя страницы § Переменные и функции синтаксического анализатора.

Переменная сайтаВыходОписание
{{SITENAME}}ВикипедияИмя сайта ($wgSitename).
{{SERVER}}//ru.wikipedia.orgURL-адрес домена ($wgServer).
{{SERVERNAME}}ru.wikipedia.orgСубдомен и доменное имя.
{{ARTICLEPATH}}/вики/$1Относительный путь к статье ($wgArticlePath).
{{SCRIPTPATH}}/жОтносительный путь к скрипту ($wgScriptPath).
{{STYLEPATH}}/со/скинамиОтносительный путь стиля ($wgStylePath).
{{CURRENTVERSION}}1.44.0-wmf.14 (47ccde2)Возвращает текущую версию MediaWiki.

Другие переменные по типу

Текущая дата и время
Всемирное времяВремя локального сайта
ПеременнаяВыходПеременнаяВыход
{{CURRENTYEAR}}2025{{LOCALYEAR}}2025
{{CURRENTMONTH}}02{{LOCALMONTH}}02
{{CURRENTMONTHNAME}}февраль{{LOCALMONTHNAME}}февраль
{{CURRENTMONTHABBREV}}февр.{{LOCALMONTHABBREV}}февр.
{{CURRENTDAY}}[б]3{{LOCALDAY}}[б]3
{{CURRENTDAY2}}[б]03{{LOCALDAY2}}[б]03
{{CURRENTDOW}}1{{LOCALDOW}}1
{{CURRENTDAYNAME}}Понедельник{{LOCALDAYNAME}}Понедельник
{{CURRENTTIME}}22:00{{LOCALTIME}}22:00
{{CURRENTHOUR}}22{{LOCALHOUR}}22
{{CURRENTWEEK}}6{{LOCALWEEK}}6
{{CURRENTTIMESTAMP}}[с]20250203220049{{LOCALTIMESTAMP}}[с]20250203220049
Данные о ревизии страницы
ПеременнаяВыход
{{REVISIONDAY}}[б]1
{{REVISIONDAY2}}[б]01
{{REVISIONMONTH}}01
{{REVISIONYEAR}}2025
{{REVISIONTIMESTAMP}}[с]20250101034947
{{REVISIONUSER}}[г]Вадди96
Статистика Вики
{{NUMBEROFPAGES}}62,457,804
{{NUMBEROFARTICLES}}6,949,183
{{NUMBEROFFILES}}932,177
{{NUMBEROFEDITS}}1,269,002,184
{{NUMBEROFUSERS}}48,654,455
{{NUMBEROFADMINS}}847
{{NUMBEROFACTIVEUSERS}}126,245

Функции парсера

Ярлыки
  • ВП:ПФ
  • WP:ПАРСЕР

Метаданные

ФункцияОписание
{{PAGEID}}Уникальный номер идентификатора страницы (например, идентификатор этой страницы —3235121).
{{PAGESIZE:fullpagename}}[e]Размер именованной страницы в байтах (например, эта страница36,387байт).
{{PROTECTIONLEVEL:action|fullpagename}}Уровень защиты, назначенный действию («редактировать», «переместить» и т. д.) на указанной странице (уровень защиты этой страницы для «редактировать» — autoconfirmed).
{{PROTECTIONEXPIRY:action|fullpagename}}Истечение срока защиты, назначенное действию («редактировать», «переместить» и т. д.) на указанной странице (срок действия защиты этой страницы составляет infinity).
{{PENDINGCHANGELEVEL:fullpagename}}Уровень защиты для ожидающих изменений на указанной странице (эта страница, на которой его нет, — ).
{{PAGESINCATEGORY:categoryname}}Количество страниц в категории с названием categoryname . Каждая подкатегория считается как один элемент.
{{NUMBERINGROUP:groupname}}Количество пользователей в группе пользователей с именем groupname .

Идентификаторы страниц могут быть связаны со статьями через викиссылки (т.е. Special:Redirect/page/3235121переходят на эту страницу). Чтобы вывести числа без запятых- разделителей (например, как "123456789" вместо "123,456,789"), добавьте параметр |R.

Форматирование

ФункцияОписание
{{lc:string}}Преобразует все символы в строке в нижний регистр.
{{lcfirst:string}}Преобразует первый символ строки в нижний регистр.
{{uc:string}}Преобразует все символы в строке в верхний регистр.
{{ucfirst:string}}Преобразует первый символ строки в верхний регистр.
{{formatnum:unformatted_number}}
{{formatnum:formatted_num |R}}		Добавляет разделители-запятые к неформатированному числу (например, 123456789 становится 123,456,789). Чтобы удалить такое форматирование, используйте ( например, ie дает 7654321).{{formatnum:formatted_number|R}}{{formatnum:7,654,321|R}}
{{#dateformat:date|format}}
{{#formatdate:date|format}}		Форматирует дату в соответствии с предпочтениями пользователя; для пользователей без предпочтений по дате можно задать значение по умолчанию в качестве необязательного второго параметра с учетом регистра; можно преобразовать дату из существующего формата в любой из форматов dmy, mdy, ymdили ISO 8601, при этом предпочтения пользователя переопределяют указанный формат.
{{padleft:xyz|stringlength}}
{{padright:xyz|stringlength}}

{{padleft:xyz|length|padstr}}
{{padright:xyz|length|padstr}}		Дополните строку нулями «0» справа или слева, чтобы заполнить указанную длину; альтернативную строку дополнения можно задать в качестве третьего параметра; повторяющаяся строка дополнения ( padstr ) будет усечена, если ее длина не делит нацело требуемое количество символов.
{{plural:N|singular|plural}}Выводит единственное число, если N равно 1, в противном случае выводит множественное число . Подробности смотрите в документации на mediawiki.org.
{{#time:format|object}}
{{#timel:format|object}}

{{#time:d F Y|date|langcode}}

{{#timef:object|format type|langcode}}		Используется для форматирования дат и времени, для формата ISO, точек или названий месяцев на английском языке. #timelи #timeflоснованы на местном времени, как определено для каждой вики; для английской Википедии это идентично #timeи #timef.
Необязательный 3-й параметр — это код языка вывода (французский, немецкий, шведский: fr, de, sv и т. д.). Пример финский: {{#time:d F Y|June 30, 2016|fi}}показывает: 30 kesäkuu 2016 (июнь). ISO на немецкий: {{#time:d. M Y|1987-10-31|de}}показывает: 31. Okt. 1987.
Коды формата см. в: mw:Help:Extension:ParserFunctions##time. Используйте формат {{#time: H:i, j F Y (e)|...}}для соответствия формату, используемому временными метками в подписях.
#timefформатирует дату, используя стандартный формат для выбранного языка, см. в: mw:Help:Extension:ParserFunctions##timef.
{{gender:user|m_out|f_out|u_out}}Выводит m_out , f_out или u_out в зависимости от того, является ли пол, указанный в предпочтениях пользователя  , соответственно, мужским, женским или неуказанным. Доступны другие перестановки параметров, см. mw:Help:Magic words#gender и translatewiki:Gender.
{{#tag:tagname|content with magic}}Единственный способ оценить магические слова внутри тега , чтобы сгенерировать . Также обрабатывает атрибуты тега. Подробности на mw:Help:Magic words#tag.<tagname>magic</tagname>

Пути

ФункцияОписание
{{localurl:fullpagename |query}}Относительный путь к имени страницы. Параметр запроса необязателен.
{{fullurl:fullpagename |query}}Абсолютный путь, без префикса протокола (т.е. без "  http:  " и т.п.), к имени страницы. Параметр запроса необязателен.
{{canonicalurl:fullpagename |query}}Абсолютный путь, включая префикс протокола, к имени страницы. Параметр запроса необязателен.
{{filepath:filename}}Абсолютный путь к медиафайлу filename .
{{urlencode:string}}Кодирует строку для использования в строках запроса URL; {{urlencode:test string}}например, создает: test+string. Чтобы закодировать строку для использования в путях URL или именах страниц MediaWiki, добавьте, соответственно, |PATHили |WIKI(чтобы создать "test%20string" или "test_string").
{{anchorencode:string}}Входные данные закодированы для использования в якорях разделов URL MediaWiki .
{{ns:n}}Возвращает имя пространства имен , индекс которого равен числу n . Для URL-адресов MediaWiki используйте {{nse:}}.
{{#rel2abs:path}} Преобразует относительный путь к файлу в абсолютный путь.
{{#titleparts:fullpagename|number|first segment}}Разбивает полное имя страницы (заголовок) на указанное количество сегментов.

Условный

ФункцияОписание
{{#expr:expression}} Оценивает выражение (см. синтаксис функции парсера mw:Manual:Expr).
{{#if:string |result1 |result2}} Выводит result2, если строка пуста , в противном случае выводит result1 .
{{#ifeq:string1|string2 |result1 |result2}} Выводит result1 , если string1 и string2 равны (в алфавитном или числовом отношении), в противном случае выводит result2 .
{{#iferror:test_string |result1 |result2}} Выводит result1 , если test_string генерирует ошибку синтаксического анализа, в противном случае выводит result2 .
{{#ifexpr:expression |result1 |result2}} Выводит result1, если выражение  истинно, в противном случае выводит result2 .
{{#ifexist:pagetitle |result1 |result2}}[e]Выводит result1 , если страница [[ pagetitle ]] существует, в противном случае выводит result2 . Обратите внимание, что подчеркивания необходимы для пробелов в пространствах имен.
{{#switch:string |c1=r1 |c2=r2 ... |default}} Выводит r1, если строка равна c1 , r2, если строка равна c2 и т. д., в противном случае выводит значение по умолчанию (если указано).

Если в этих условных функциях пустые неименованные параметры должны анализироваться как пустые, а не как текст (т. е. как пустые, а не как текст "{{{1}}}", "{{{2}}}" и т. д.), то для них потребуются конечные символы вертикальной черты (т. е {{{1|}}}. , {{{2|}}}, и т. д., а не {{{1}}}, , {{{2}}}и т. д.).

Другой

ФункцияОписание
{{#babel:code1|code2|...}}Отрисовывать пользовательские боксы , сообщающие о ваших языковых навыках. Улучшает {{ Babel }} (альтернатива).
{{#categorytree:category|...}}Рекурсивно перечислить страницы в категории.
{{#coordinates:arg1|arg2|...}}Сохраните координаты GeoData объекта в базе данных страницы. Используется в {{ coord }} .
{{#invoke:module|function|arg1|...}}Используйте Scribunto для включения шаблона lua , например, функции replace в модуле String .
{{#language:code1|code2}}Печатать имя, представленное кодом языка, например en → English . Печатать на языке 2, если он указан, например {{#language:en|zh}}печатает 英语
{{#lst:}}, {{#lsth:}}, {{#lstx:}}Три способа транспонирования раздела страницы .
{{#mentor:Username}}Отображение текущего назначенного наставника для целевого имени пользователя, если он установлен.
{{#property:arg1|arg2|...}}Включить свойство ( Wikidata ) из именованной сущности вместо свойства по умолчанию на странице.
{{#related:...}}Ссылки на похожие темы для привлечения читателей. (Бета-функция.)
{{#section:}}, {{#section-h:}}, {{#section-x:}}Псевдонимы для {{#lst:}}, {{#lsth}}, {{#lstx}}(выше).
{{#statements:arg1|...}}Отображение значения любого утверждения (Викиданных), включенного в элемент.
{{#target:fullpagename}}Отправьте сообщение списку страниц обсуждения на fullpagename, используя функцию MassMessage.
{{int:pagename}} Включить сообщение интерфейса , т.е. имя страницы в пространстве имен MediaWiki
{{!}} Используется для включения символа вертикальной черты как части аргумента шаблона или содержимого ячейки таблицы. До того, как это было добавлено как волшебное слово, многие вики реализовывали это, создавая Template:! с |содержимым.
{{=}} Используется для включения знака равенства как части аргумента шаблона или содержимого ячейки таблицы. До того, как это было добавлено как волшебное слово, многие вики реализовывали это, создавая Template:= с =содержимым.

Подстановка и вложение

Волшебные слова иногда могут вести себя странно при замене или вложении. Некоторые волшебные слова можно заменить (чтобы страница перестала обновляться, если значение слова изменилось). Вот несколько примеров того, как это работает:

Синий вопросительный знак?КодВыход
Красный символ XН{{PAGESIZE}}0
Зеленая галочкаИ{{PAGESIZE:Help:Magic words}}36,387
Зеленая галочкаИ{{subst:PAGESIZE:Help:Magic words}}36,387
Зеленая галочкаИ{{PAGESIZE:{{FULLPAGENAME}}}}36,387
Красный символ XН{{subst:PAGESIZE:{{FULLPAGENAME}}}}0
Зеленая галочкаИ{{PAGESIZE:{{subst:FULLPAGENAME}}}}36,387
Зеленая галочкаИ{{subst:PAGESIZE:{{subst:FULLPAGENAME}}}}36,387

Смотрите также

  • mw:Локализация
  • mw:Руководство:Расширение вики-разметки
  • CoreParserFunctions.php
  • Настройки  → Гаджеты  → Редактирование  →Галочка (S) Подсветка синтаксиса: альтернатива цветовой подсветке синтаксиса вики по умолчанию в поле редактирования (лучше всего работает в Firefox и почти всегда работает в Chrome и Opera )
  • Special:Version , см. последний раздел «Перехватчики функций парсера»: список, который должен включать все волшебные слова на этой странице
  • {{ Ifexist not redirect }} , работает с {{#ifexist:}}выражением, позволяя идентифицировать и анализировать перенаправления по-разному

Примечания

  1. ^ Если {{FULLPAGENAME}}используется на странице, которая включена с другой страницы, будет возвращено имя цели. {{ #invoke:TEMPLATENAME |main}} можно использовать для определения имени самого шаблона.
  2. ^ abcdef {{CURRENTDAY}}и возвращает день (например, {{LOCALDAY}}"{{REVISIONDAY}}6"), в то время как {{CURRENTDAY2}}, {{LOCALDAY2}}и {{REVISIONDAY2}}возвращают день с дополнением нулями (например, "06"). Для всех двузначных дней (т.е. с 10 по 31) они одинаковы.
  3. ^ abc Эти выходные данные временных меток можно форматировать с помощью {{ Format revisiontimestamp }} (он же {{ FRTS }} ). Например, {{ FRTS |{{REVISIONTIMESTAMP}}}} преобразует "20250101034947" в "2025-01-01 03:49:47".
  4. ^ Это показывает последнего пользователя, который редактировал страницу. Нет возможности показать пользователя, просматривающего страницу, с помощью магических слов из-за технических ограничений.
  5. ^ ab Эта функция является дорогостоящей функцией синтаксического анализатора.
Взято с "https://en.wikipedia.org/w/index.php?title=Help:Волшебные_слова&oldid=1266545897"