Волшебные слова (включая функции парсера , переменные и переключатели поведения ) — это функции вики-разметки , которые дают инструкции базовому программному обеспечению MediaWiki Википедии . Например, волшебные слова могут подавлять или позиционировать оглавление, отключать индексацию внешними поисковыми системами и динамически выводить данные на основе текущей страницы или на основе пользовательской условной логики. Некоторые из этих функций особенно полезны для шаблонов .
Эта страница — краткий справочник по волшебным словам. Для получения дополнительной информации обратитесь к основной документации MediaWiki:
Вообще, существует три типа магических слов.
__NOTOC__
. Они изменят поведение страницы, а не вернут значение.{{#ifexpr:Y|Yes|No}}
, заключенные в двойные фигурные скобки. Они принимают значение и возвращают значение.{{PAGENAME}}
. Переменная будет заключена в двойные скобки и вернет значение на своем месте.Программное обеспечение обычно интерпретирует магические слова следующим образом:
<nowiki>
<nowiki>{{#magic:}}</nowiki>
{{#magic:<nowiki/>}}
Волшебные слова в сравнении с шаблонами:
#
( решетки или хэша ), но имена шаблонов не будут начинаться с (решетки#
) и, вероятно, не будут заканчиваться на :
(двоеточие) или будут полностью заглавными.{{#magic: p1 | p2 | p3}}
, имя — #magic
и за ним следует неразделенный :
и обязательный входной параметр, p1
. С шаблоном p1
является необязательным и ему предшествует |
(вертикальная черта) вместо :
, например {{template|p1}}
.Большинство волшебных слов можно использовать в любых нужных местах на странице; см. MOS:ORDER для получения рекомендаций о том, где размещать волшебные слова, являющиеся переключателями поведения.
Примечание: Волшебные слова выше также могут принимать параметр, чтобы анализировать значения на странице, отличной от текущей. :Для передачи параметра используется двоеточие ( ), а не вертикальная черта ( |), которая используется в шаблонах, например {{MAGICWORD:value}}. Например, {{TALKPAGENAME:Wikipedia:MOS}}возвращаетОбсуждение Википедии:MOSна любой странице.
Примечание: В пространствах имен «Категория» и «Обсуждение категории» для вики-ссылки (некоторых) переменных имен страниц может потребоваться добавление двоеточия в качестве префикса , чтобы избежать нежелательной категоризации.
Идентификаторы страниц могут быть связаны со статьями через викиссылки (т.е. Special:Redirect/page/3235121
переходят на эту страницу). Чтобы вывести числа без запятых- разделителей (например, как "123456789" вместо "123,456,789"), добавьте параметр |R.
Если в этих условных функциях пустые неименованные параметры должны анализироваться как пустые, а не как текст (т. е. как пустые, а не как текст "{{{1}}}", "{{{2}}}" и т. д.), то для них потребуются конечные символы вертикальной черты (т. е {{{1|}}}. , {{{2|}}}, и т. д., а не {{{1}}}, , {{{2}}}и т. д.).
Волшебные слова иногда могут вести себя странно при замене или вложении. Некоторые волшебные слова можно заменить (чтобы страница перестала обновляться, если значение слова изменилось). Вот несколько примеров того, как это работает:
{{#ifexist:}}
выражением, позволяя идентифицировать и анализировать перенаправления по-разному