WikiDer > Справка: Волшебные слова - Википедия

Help:Magic words - Wikipedia

"WP: MAGIC" перенаправляется сюда. Для WikiProject Magic см. Википедия: WikiProject Magic.
Для введения см. Справка: Волшебные слова для начинающих.

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

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

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

В общем, есть три типа волшебных слов

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

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

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

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

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

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

Дальнейшая информация: mw: Help: Волшебные слова § Переключатели поведения
ВыключательОписание
__TOC__Размещает страницы оглавление (TOC) в позиции слова.
__FORCETOC__Заставляет TOC отображаться в позиции по умолчанию. Может использоваться где угодно на странице.
__NOTOC__Подавляет отображение оглавления страницы. Может использоваться где угодно на странице.
__NOEDITSECTION__Обычно скрывает ссылки "изменить" рядом с все заголовки на странице. Чтобы скрыть ссылку редактирования рядом с частности заголовок укажите заголовок, например, ан HTML-тег Такие как <h2>Заголовок</h2> а не с обычным синтаксисом знаков равенства вики (например, == Заголовок == ).
__NEWSECTIONLINK__На страницах без обсуждения добавляет ссылку «Новый раздел» как средство для добавления нового раздела на страницу.
__NONEWSECTIONLINK__Удаляет ссылку «Новый раздел» (ссылка добавления нового раздела) на страницах обсуждения.
__NOGALLERY__Заменяет эскизы на странице категории обычными ссылками.
__HIDDENCAT__Делает категорию скрытый при включении на страницу этой категории.
__ИНДЕКС__Поручает поисковые системы для индексации страницы.
__NOINDEX__Указывает поисковым системам не индексировать страницу. Видеть Википедия: Контроль индексации поисковыми системами.
__STATICREDIRECT__Предотвращает ссылку на перенаправление страница не обновляется автоматически при перемещении страницы, на которую она перенаправляется (и установлен флажок «Обновлять любые перенаправления, указывающие на исходный заголовок»). Также инструктирует интервики боты обрабатывать страницу как статью.
__DISAMBIG__Помечает страницу как страница значений, добавляет его в Special: DisambiguationPages и размещает внутренние ссылки в Special: DisambiguationPageLinks. (Видеть mw: Расширение: устранение неоднозначности.)
{{DISPLAYTITLE:заглавие}}Используется для изменения отображаемая форма заголовка страницы.
{{DEFAULTSORT:ключ сортировки}}Устанавливает значение по умолчанию ключ (индекс), по которому страница классифицируется.
{{NOEXTERNALLANGLINKS}}(эквивалентно {{NOEXTERNALLANGLINKS | *}} ) Подавляет автоматическое включение Викиданные межъязыковые ссылки в левой части страницы. Ссылки на определенные, а не на все языки могут быть подавлены с помощью {{NOEXTERNALLANGLINKS |список}}, куда список а трубка-ограниченный Список языковые коды (например, {{NOEXTERNALLANGLINKS | fr | es | ja}} для подавления французских ("fr"), испанских ("es") и японских ("ja") межъязыковых ссылок).

Переменные

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

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

Примечание:В пространствах имен "Категория" и "Обсуждение категорий" для вики-ссылки (некоторых) переменных имени страницы может потребоваться префикс двоеточия чтобы избежать нежелательной категоризации.

Переменная сайтаПримерОписание
{{НАЗВАНИЕ САЙТА}}Википедия
{{СЕРВЕР}}//en.wikipedia.org
{{ИМЯ СЕРВЕРА}}en.wikipedia.org
{{SCRIPTPATH}}/ w
{{ТЕКУЩАЯ ВЕРСИЯ}}1.36.0-WMF.22 (6c97eed)Возвращает текущую версию MediaWiki.

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

Дата и времяДанные ревизииСтатистика
Всемирное время
  • {{ТЕКУЩИЙ ГОД}}
  • {{ТЕКУЩИЙ МЕСЯЦ}}
  • {{CURRENTMONTHNAME}}
  • {{CURRENTMONTHABBREV}}
  • {{ТЕКУЩИЙ ДЕНЬ}}
  • {{CURRENTDAY2}}
  • {{CURRENTDOW}}
  • {{CURRENTDAYNAME}}
  • {{ТЕКУЩЕЕ ВРЕМЯ}}
  • {{CURRENTHOUR}}
  • {{ТЕКУЩАЯ НЕДЕЛЯ}}
  • {{CURRENTTIMESTAMP}}
Местное время на сайте
  • {{LOCALYEAR}}
  • {{LOCALMONTH}}
  • {{LOCALMONTHNAME}}
  • {{LOCALMONTHABBREV}}
  • {{LOCALDAY}}
  • {{LOCALDAY2}}
  • {{LOCALDOW}}
  • {{LOCALDAYNAME}}
  • {{МЕСТНОЕ ВРЕМЯ}}
  • {{LOCALHOUR}}
  • {{LOCALWEEK}}
  • {{LOCALTIMESTAMP}}
  • {{REVISIONDAY}}
  • {{REVISIONDAY2}}
  • {{REVISIONMONTH}}
  • {{REVISIONYEAR}}
  • {{REVISIONTIMESTAMP}}
  • {{REVISIONUSER}}а
  • {{ЧИСЛО СТРАНИЦ}}
  • {{NUMBEROFARTICLES}}
  • {{NUMBEROFFILES}}
  • {{NUMBEROFEDITS}}
  • {{КОЛИЧЕСТВО ПОЛЬЗОВАТЕЛЕЙ}}
  • {{NUMBEROFADMINS}}
  • {{NUMBEROFACTIVEUSERS}}
а Это показывает последнего пользователя, который редактировал страницу. Нет возможности показать пользователю просматривающую страницу из-за технических ограничений.

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

Ярлыки
Дальнейшая информация: mw: Справка: волшебные слова § Функции парсера, и mw: Справка: Расширение: Функции парсера

Метаданные

ФункцияОписание
{{PAGEID}}Уникальный идентификационный номер страницы.
{{РАЗМЕР СТРАНИЦЫ:fullpagename}}Размер именованной страницы в байтах.
{{УРОВЕНЬ ЗАЩИТЫ:действие|fullpagename}}Уровень защиты назначен действие («редактировать», «перемещать» и т. д.) на указанной странице.
{{PROTECTIONEXPIRY:действие|fullpagename}}Срок действия защиты назначен действие («редактировать», «перемещать» и т. д.) на указанной странице.
{{PENDINGCHANGELEVEL}}Уровень защиты для ожидающие изменения на текущей странице.
{{PAGESINCATEGORY:название категории}}Количество страниц в названной категории название категории. Каждая подкатегория считается как один элемент.
{{NUMBERINGROUP:Название группы}}Количество пользователей в группа пользователей названный Название группы.

Для вывода чисел без запятой разделители (например, как «123456789», а не «123,456,789»), добавьте параметр | R.

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

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

{{padleft:xyz|длина|Padstr}}
{{padright:xyz|длина|Padstr}} 		Заполните нулями «0» справа или слева, чтобы заполнить заданную длину; альтернативная строка заполнения может быть указана как третий параметр; повторяющаяся строка заполнения (Padstr) будет усечен, если его длина не делит равномерно необходимое количество символов.
{{множественное число:N|единственное число|множественное число}} Выходы единственное число если N равно 1, иначе выходы множественное число. Увидеть документация на mediawiki.org Больше подробностей.
{{#время:формат|объект}}
{{#timel:формат|объект}}

{{#time: d F Y |Дата|langcode}} 		Используется для форматирования даты и времени, для формата ISO, точек или английских названий месяцев. #timel основывается на местном времени, определенном для каждой вики; для английской Википедии это идентично #время.
Необязательный третий параметр - это код языка вывода (французский, немецкий, шведский: fr, de, sv и т. Д.). Пример финский: {{#time: d F Y | 30 июня 2016 г. | fi}} шоу: 30 kesäkuu 2016 (июнь). ISO на немецкий: {{#time: d. M Y | 1987-10-31 | de}} показов: 31. Окт. 1987 г.
Коды форматов см .: mw: Справка: Расширение: ParserFunctions ## time. Используйте формат {{#time: H: i, j F Y (e) | ...}} чтобы соответствовать формату, используемому метками времени в подписях.
{{Пол:Пользователь|m_out|f_out|u_out}} Выходы m_out, f_out или же u_out в зависимости от пола, указанного в Пользователь предпочтения соответственно мужского, женского или неопределенного пола. Доступны другие варианты перестановки параметров, см. mw: Help: Волшебные слова # пол и translatewiki: Пол.
{{#тег:тег|довольствоваться магией}} Единственный способ оценивать волшебные слова внутри тега, чтобы создать <тег>магия</тег>. Также обрабатывает атрибуты тегов.

Пути

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

Условный

Дальнейшая информация: Справка: условные выражения
ФункцияОписание
{{#expr:выражение}}Оценивает выражение (видеть m: Справка: Расчет).
{{#если:нить |результат1 |результат2}}Выходы результат2 если нить является пустой, иначе выводит результат1.
{{#ifeq:строка1|строка2 |результат1 |результат2}}Выходы результат1 если строка1 и строка2 равны (по алфавиту или по цифрам), в противном случае выходы результат2.
{{#iferror:test_string |результат1 |результат2}}Выходы результат1 если test_string генерирует ошибку синтаксического анализа, иначе выводит результат2.
{{#ifexpr:выражение |результат1 |результат2}}Выходы результат1 если выражение  верно, иначе выводит результат2.
{{#ifexist:Заголовок страницы |результат1 |результат2}}Выходы результат1 если страница [[Заголовок страницы]] существует, иначе выводит результат2. Обратите внимание, что подчеркивания необходимы для пробелов в пространствах имен.
{{#выключатель:нить |c1=r1 |c2=r2 ... |дефолт}}Выходы r1 если нить является c1, r2 если нить является c2и т. д., иначе выводит дефолт (если предусмотрено).

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

Другой

ФункцияОписание
{{#babel:code1|code2|...}}Оказывать wp: ящики пользователей рассказывая о своих языковых навыках. Улучшает {{Вавилон}} (альтернатива).
{{#categorytree:категория|...}}Рекурсивный список страниц в категории.
{{#координаты:arg1|arg2|...}}Спасти Координаты GeoData темы в базу данных страницы. Используется в {{согласовывать}}.
{{#invoke:модуль|функция|arg1|...}}Использовать Скрибунто включить lua шаблон, например функция заменять в модуль Нить.
{{#язык:code1|code2}}Выведите имя, представленное кодом языка, например en → английский. Печатайте на языке 2, если он указан.
{{#lst:}} {{#lsth:}} {{#lstx:}}Три способа включить раздел страницы.
{{#свойство:arg1|arg2|...}} Включите свойство (Викиданные) из именованного объекта вместо значения по умолчанию на странице.
{{#связанные с:...}}Ссылки на похожие темы, чтобы заинтересовать читателей. (Бета-функция.)
{{#section:}} {{# section-h:}} {{# section-x:}}Псевдонимы для {{#lst:}} {{#lsth}} {{#lstx}} (над).
{{#заявления:arg1|...}} Отобразите значение любого утверждения, включенного в элемент.
{{#цель:fullpagename}}Отправьте сообщение в список страниц обсуждения на полной странице, используя Функция MassMessage.
{{int:имя страницы}}Включить ан интерфейс сообщение, т.е. имя страницы в пространстве имен MediaWiki

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