Справка:Волшебные слова

 В избранное 
Материал из Интервики
Перейти к: навигация, поиск

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

Основные замечания[править]

  • Наследование: переменные и «магические выражения», зависящие от страницы, возвращают значения в зависимости от просматриваемой страницы, независимо от того, присутствуют они в коде страницы или включены через другую страницу.

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

Переключатели поведения — «волшебные слова», влияющие на оформление страниц в вики.

Выражение Описание Версия
Содержание
__NOTOC__ Скрывает оглавление страницы (TOC).
__FORCETOC__ Заставляет содержание подниматься выше определённого уровня (в нулевой секции).
__TOC__ Размещает оглавление в текущюю позицию (противоположно «слову» __ NOTOC __). Если используется _TOC_, то оглавление вернётся в исходное место на странице.
Редактирование
__NOEDITSECTION__ Скрывает ссылки «править» для каждой секции страницы
__NEWSECTIONLINK__ Добавляет кнопку ((«+» по умолчанию) рядом с кнопкой «править» на любых страницах (см. m:Help:Section#Adding a section at the end). 1.7+
Категории
__NOGALLERY__ Используется для категорий, в которые включено большое количество изображений. Это «слово» заменяет изображения на простые ссылки. 1.7+
__HIDDENCAT__ Используется в категории и позволяет скрыть эту категорию из более старших категорий (в которые включена данная категория) (более подробно — см. настройки участника). 1.13+
{{DEFAULTSORT:xyz}} Устанавливает ключ сортировки на сортируемой странице 1.10+
Преобразование языков
__NOCONTENTCONVERT__
__NOCC__
Запрещает выполнение языковой конвертации содержания на сайтах с языковыми вариантами. Например, будет отображён только китайский (zh), вместо таких вариантов, как zh_cn, zh_tw, zh_sg, или zh_hk.
__NOTITLECONVERT__
__NOTC__
Запрещает выполнение языковой конвертации заголовка на сайтах с языковыми вариантами (прочее содержание будет проходить конверсию).
Разное
{{DISPLAYTITLE:xyz}} Форматирует заголовок текущей страницы. Значение должно быть эквивалентно стандартному заголовку: допустимо лишь изменение регистра и замена пробелов на подчёркивания. Функцию можно отключить через переменную {{ #ifeq:
 interwiki.info
www.mediawiki.org $wgAllowDisplayTitle $wgAllowDisplayTitle

}}; по умолчанию отключена до 1.10+, затем включена.

1.7+
__END__ Обозначает конец страницы, не давая MediaWiki удалить её. Функция удалена, см. 19213.
__START__ Нет эффекта.
__NOINDEX__ Запрещает индексацию страницы поисковыми системами (страница не будет отображена в результатах поиска). {{ #ifeq:
 interwiki.info
www.mediawiki.org 1.13+ 1.13+

}}

__INDEX__ Позволяет поисковым системам индексировать страницу (переписывает {{ #ifeq:
 interwiki.info
www.mediawiki.org $wgArticleRobotPolicies $wgArticleRobotPolicies

}}, но не robots.txt).

1.13+
__STATICREDIRECT__ Помещённая на страницу перенаправления, запрещает MediaWiki автоматически исправлять двойные перенаправления. {{ #ifeq:
 interwiki.info
www.mediawiki.org 1.13+ 1.13+

}}

#REDIRECT [[Page name]] Перенаправляет с текущей страницы на другую.

Переменные[править]

Синтаксис большинства переменных похож на синтаксис шаблонов, но для избежания конфликтов обычно использует только заглавные буквы. Если имя шаблона совпадает с переменной, то вызывается переменная; для принудительного вызова шаблона используйте префикс msg:, например {{msg:CURRENTYEAR}}. В некоторых случаях, добавление параметров может вызвать подключение шаблона; например, {{CURRENTDAYNAME|x}} приведёт в включению шаблона «Шаблон:CURRENTDAYNAME».

Функции парсера похожи на переменные, но срабатывают на месте ввода, а не на всей странице. Первый параметр отделён двоеточием (:), а не вертикальным слэшем (|). (На этой странице не описаны функции расширения {{ #ifeq:

 interwiki.info

| www.mediawiki.org | ParserFunctions extension | ParserFunctions extension }}.)

Дата и время[править]

Следующие переменные возвращают текущую дату и время, основываясь на часовом поясе пользователя, указанном в настройках. Часовой пояс по умолчанию — UTC.

Вследствие кэширования страниц браузером и MediaWiki, эти переменные часто показывают когда страница была закэширована, вместо отображения текущего времени.

Переменная Возвращаемое значение Описание Версия
Год
{{CURRENTYEAR}} 2019 Год
Текущий месяц
{{CURRENTMONTH}} 03 Месяц (число)
{{CURRENTMONTHNAME}} март Текущий месяц (название)
{{CURRENTMONTHNAMEGEN}} марта Текущий месяц (в родительном падеже)
{{CURRENTMONTHABBREV}} мар Текущий месяц (аббревиатура) 1.5+
День
{{CURRENTDAY}} 24 День месяца (1..31)
{{CURRENTDAY2}} 24 День месяца (с ведущим нулём: 01..31) 1.6+
{{CURRENTDOW}} 0 День недели (число)
{{CURRENTDAYNAME}} воскресенье День недели (название)
Время
{{CURRENTTIME}} 05:39 Текущее время (24-часовой формат — HH:mm)
{{CURRENTHOUR}} 05 Час (01..24)
Разное
{{CURRENTWEEK}} 12 Текущая неделя (число)
{{CURRENTTIMESTAMP}} 20190324053950 Время по стандарту ISO 8601 1.7+

Следующие переменные возвращают подобные значения, что и выше, но используют локальный часовой пояс, не зависимо от настроек пользователя и UTC:

  • {{LOCALYEAR}}
  • {{LOCALMONTH}}
  • {{LOCALMONTHNAME}}
  • {{LOCALMONTHABBREV}}
  • {{LOCALDAY}}
  • {{LOCALDAY2}}
  • {{LOCALDOW}}
  • {{LOCALDAYNAME}}
  • {{LOCALTIME}}
  • {{LOCALHOUR}}
  • {{LOCALWEEK}}
  • {{LOCALTIMESTAMP}}

Технические метаданные[править]

Следующие переменные возвращают значения, связанные с последней правкой текущей статьи, независимо от просматриваемой версии.

Переменная Возвращаемое значение Описание Версия
Сайт
{{SITENAME}} Интервики Имя сайта ({{ #ifeq:
 interwiki.info
www.mediawiki.org $wgSitename $wgSitename

}})

{{SERVER}} http://interwiki.info URL домена({{ #ifeq:
 interwiki.info
www.mediawiki.org $wgServer $wgServer

}})

{{SERVERNAME}} interwiki.info доменное имя ({{ #ifeq:
 interwiki.info
www.mediawiki.org $wgServerName $wgServerName

}})

{{DIRMARK}}
{{DIRECTIONMARK}}

Outputs a unicode-directional mark that matches the wiki's default language's direction (‎ on left-to-right wikis, ‏ on right-to-left wikis), useful in text with multi-directional text. 1.7+
{{SCRIPTPATH}} относительный путь к скрипту ({{ #ifeq:
 interwiki.info
www.mediawiki.org $wgScriptPath $wgScriptPath

}})

{{CURRENTVERSION}} 1.30.0 Версия MediaWiki, на которой работает вики-проект. 1.7+
{{CONTENTLANGUAGE}} ru Язык интерфейса по умолчанию ({{ #ifeq:
 interwiki.info
www.mediawiki.org $wgLanguageCode $wgLanguageCode

}})

1.7+
Последняя правка статьи
{{REVISIONID}} 3962 Уникальный идентификатор правки
{{REVISIONDAY}} 11 День совершения правки (без ведущего нуля)
{{REVISIONDAY2}} 11 День совершения правки (с ведущим нулём)
{{REVISIONMONTH}} 04 Месяц совершения правки (без ведущего нуля)
{{REVISIONYEAR}} 2009 Год совершения правки
{{REVISIONTIMESTAMP}} 20090411125943 Дата совершения правки в формате ISO 8601
{{PAGESIZE:page name}} 0 Returns the byte size of the specified page. {{ #ifeq:
 interwiki.info
www.mediawiki.org 1.13+ 1.13+

}}

{{PROTECTIONLEVEL:action}} protection level Outputs the protection level (e.g. 'autoconfirm', 'sysop') for a given action (e.g. 'edit', 'move') on the current page or an empty string if not protected. 1.15+
Affects page content
{{DISPLAYTITLE:title}} Format the current page's title header. The value must be equivalent to the default title: only capitalization changes and replacing spaces with underscores. It can be disabled or enabled by {{ #ifeq:
 interwiki.info
www.mediawiki.org $wgAllowDisplayTitle $wgAllowDisplayTitle

}}; disabled by default before 1.10+, enabled by default thereafter.

1.7+
{{DEFAULTSORT:sortkey}} Используется на страницах категорий, устанавливает ключ сортировки в категории по умолчанию. 1.10+

Статистика[править]

Числа, возвращаемые этими переменными, содержат разделители разрядов. Для получения неотформатированных чисел используется флаг «:R» (например, {{NUMBEROFPAGES}} = 2869 и {{NUMBEROFPAGES:R}} = 2869). Для волшебных слов, требующих параметра, таких как PAGESINCATEGORY, используйте «|R» (например, {{PAGESINCATEGORY:Help}} и {{PAGESINCATEGORY:Help|R}}).

Переменная Возвращаемое значение Описание Версия
По вики-проекту в целом
{{NUMBEROFPAGES}} 2869 Количество вики-страниц 1.7+
{{NUMBEROFARTICLES}} 874 Количество страниц в основном пространстве
{{NUMBEROFFILES}} 1161 Количество загруженных файлов 1.5+
{{NUMBEROFEDITS}} 15 026 Общее количество правок. 1.10+
{{NUMBEROFUSERS}} 941 Количество зарегистрированных участников. 1.7+
{{NUMBEROFADMINS}} 3 Количество участников, входящих в группу sysop. См. права участников. 1.7+
{{NUMBERINGROUP:groupname}} 4
({{NUMBERINGROUP:bureaucrat}}, число бюрократов)
Число пользователей определённой {{ #ifeq:
 interwiki.info
www.mediawiki.org группы группы

}}.

{{ #ifeq:
 interwiki.info
www.mediawiki.org 1.14+ 1.14+

}}

По пространствам имён

{{PAGESINNS:2}}
{{PAGESINNAMESPACE:2}}

отключено Количество страниц в заданном пространстве имён (замените 2 на ID нужного пространства имён). Запрещено по умолчанию, разрешается через {{ #ifeq:
 interwiki.info
www.mediawiki.org $wgAllowSlowParserFunctions $wgAllowSlowParserFunctions

}}.

1.7+
Разное
{{PAGESINCATEGORY:Help}} 0 Количество страниц в заданной категории (замените «Help» на имя нужной категории). 1.13+
{{PAGESINCAT:Help}} 0 Алиас для {{PAGESINCATEGORY}}. 1.13+
{{PAGESIZE:Help:Magic_words}} 0 Возвращает размер в байтах заданной страницы. 1.13+

Ссылки[править]

Ссылки[править]

Переменная Возвращаемое значение Описание Версия
{{SERVER}} http://interwiki.info Доменная ссылка ({{ #ifeq:
 interwiki.info
www.mediawiki.org $wgServer $wgServer

}})

{{SERVERNAME}} interwiki.info Имя домена ({{ #ifeq:
 interwiki.info
www.mediawiki.org $wgServerName $wgServerName

}})

{{SCRIPTPATH}} Относительный путь к MediaWiki ({{ #ifeq:
 interwiki.info
www.mediawiki.org $wgScriptPath $wgScriptPath

}})

{{localurl:название страницы}}
{{localurl:название страницы|строка запроса}}
/index.php?title=Pagename
/index.php?title=Pagename&query string
Относительный путь к странице
{{fullurl:page name}}
{{fullurl:page name|query_string}}
http://interwiki.info/index.php?title=Page_name
http://interwiki.info/index.php?title=Page_name&query_string
полная ссылка на страницу
{{filepath:file name}}
{{filepath:file name|nowiki}}

Полная ссылка на файл (есть ошибки с использованием nowiki) r25854
{{urlencode:x y z}} x+y+z Кодирование для URL-адреса. {{ #ifeq:
 interwiki.info
www.mediawiki.org 1.7+ 1.7+

}}

{{anchorencode:x y z}} x_y_z Кодирование URL после символа '#' (якорей). {{ #ifeq:
 interwiki.info
www.mediawiki.org 1.8+ 1.8+

}}

Названия страниц[править]

Переменная Возвращаемое значение Описание Версия
{{FULLPAGENAME}} Справка:Волшебные слова Пространство статей и название страницы
{{BASEPAGENAME}} Волшебные слова Название страницы без текущей подстраницы и без указания пространства статей («Статья» на «Статья/test»)
{{PAGENAME}} Волшебные слова Название страницы 1.7+
{{SUBPAGENAME}} Волшебные слова Название подстраницы («test» на «Страница/test») 1.6+
{{SUBJECTPAGENAME}} Справка:Волшебные слова Название основной страницы статьи. 1.7+
{{TALKPAGENAME}} Обсуждение справки:Волшебные слова Название страницы обсуждения статьи 1.7+

Эквиваленты с URL-кодированием:

  • {{FULLPAGENAMEE}}
  • {{PAGENAMEE}}
  • {{BASEPAGENAMEE}}
  • {{SUBPAGENAMEE}}
  • {{SUBJECTPAGENAMEE}}
  • {{TALKPAGENAMEE}}

Пространство имён[править]

Переменная Возвращаемое значение Описание
{{NAMESPACE}} Справка Пространство имён (название)
{{SUBJECTSPACE}} Справка Пространство имён для текущей статьи
{{TALKSPACE}} Обсуждение справки Пространство имён для текущей страницы обсуждения

Эквиваленты с URL-кодирование:

  • {{NAMESPACEE}}
  • {{SUBJECTSPACEE}}
  • {{TALKSPACEE}}

{{ns:}} возвращает локализованное название пространства имён для указанного числа или константы. Значения по умолчанию:

Использование Возвращаемое значение
{{ns:-2}} или {{ns:Media}} Медиа
{{ns:-1}} или {{ns:Special}} Служебная
{{ns:0}} или {{ns:Main}}
{{ns:1}} или {{ns:Talk}} Обсуждение
{{ns:2}} или {{ns:User}} Участник
{{ns:3}} или {{ns:User_talk}} Обсуждение участника
{{ns:4}} или {{ns:Project}} Интервики
{{ns:5}} или {{ns:Project_talk}} Обсуждение Интервики
{{ns:6}} или {{ns:Image}} Файл
{{ns:7}} или {{ns:Image_talk}} Обсуждение файла
{{ns:8}} или {{ns:MediaWiki}} MediaWiki
{{ns:9}} или {{ns:MediaWiki_talk}} Обсуждение MediaWiki
{{ns:10}} или {{ns:Template}} Шаблон
{{ns:11}} или {{ns:Template_talk}} Обсуждение шаблона
{{ns:12}} или {{ns:Help}} Справка
{{ns:13}} или {{ns:Help_talk}} Обсуждение справки
{{ns:14}} или {{ns:Category}} Категория
{{ns:15}} или {{ns:Category_talk}} Обсуждение категории

Форматирование[править]

Переменная Возвращаемое значение Описание Версия
{{lc:XYZ}} xyz Строка в нижнем регистре. 1.5+
{{lcfirst:XYZ}} xYZ Строка с первым символом в нижнем регистре. 1.5+
{{uc:xyz}} XYZ Строка в верхнем регистре. 1.5+
{{ucfirst:xyz}} Xyz Строка с первым символом в верхнем регистре. 1.5+
{{formatnum:-987654321.654321}} -987 654 321,654321 Разделяет дробную часть и разряды согласно установленной локализации 1.7+
{{padleft:xyz|5|_}}
{{padleft:xyz|5}}
__xyz
00xyz
Ввод (первый параметр) дополняется с левой стороны до указанной ширины (второй параметр) с использованием определённых символов (третий параметр). Если третий параметр не указан, строка дополняется нулями.
bug: мультибайтовые символы определяются, как двухбайтовые.
1.8+
{{padright:xyz|5|_}}
{{padright:xyz|5}}
xyz__
xyz00
Аналогично padleft, но дополняет строку с правой стороны.
{{DIRMARK}}
{{DIRECTIONMARK}}

Выводит unicode-символ направления текста, согласно локализации (‎ и ‏, для текста слева-направо и справа-налево, соответственно). Используется для текста с несколькими направлениями. 1.7+
{{plural:2|is|are}} are Выводит форму множественного числа (исключая первый параметр) в зависимости от числа (первый параметр). Например, для определения множественного числа в русском языке используется остаток от деления на 10.

Прочее[править]

Переменная Возвращаемое значение Описание Версия
{{#language:eo}} Esperanto Имя языка по языковому коду. 1.7+
{{#special:userlogin}} Служебная:Вход Локализованное имя для служебных страниц. {{ #ifeq:
 interwiki.info
www.mediawiki.org 1.9+ 1.9+

}}

{{#tag:tagname}}
{{#tag:tagname|inner content|parameter=value|parameter2=value}}
(depends on parser tag) Алиас для тегов парсера или расширений, но с возможностью обработки вики-кода. Значения атрибутов можно передать, как значения параметров ('<tagname attribute="value">' → '{{#tag:tagname|attribute=value}}'), а внутреннее содержание — как безымянный параметр ('<tagname>content</tagname>' → '{{#tag:tagname|content}}'). 1.12+

= Собственные переменные[править]

MediaWiki позволяет создавать новые переменные, как часть расширения или отдельной инсталляции. Подробную информацию см. в [1].