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

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

«Волшебные слова» в MediaWiki — комбинации текста, управляющие поведением, оформлением той или иной страницы в вики, а также выводящие некоторые полезные переменные из базы данных. Более подробную техническую информацию см. в mediawikiwiki: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}} Форматирует заголовок текущей страницы. Значение должно быть эквивалентно стандартному заголовку: допустимо лишь изменение регистра и замена пробелов на подчёркивания. Функцию можно отключить через переменную $wgAllowDisplayTitle; по умолчанию отключена до 1.10+, затем включена. 1.7+
__END__ Обозначает конец страницы, не давая MediaWiki удалить её. Функция удалена, см. 19213.
__START__ Нет эффекта.
__NOINDEX__ Запрещает индексацию страницы поисковыми системами (страница не будет отображена в результатах поиска). 1.13+
__INDEX__ Позволяет поисковым системам индексировать страницу (переписывает $wgArticleRobotPolicies, но не robots.txt). 1.13+
__STATICREDIRECT__ Помещённая на страницу перенаправления, запрещает MediaWiki автоматически исправлять двойные перенаправления. 1.13+
#REDIRECT [[Page name]] Перенаправляет с текущей страницы на другую.

Переменные

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

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

Дата и время

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

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

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

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

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

Технические метаданные

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

Переменная Возвращаемое значение Описание Версия
Сайт
{{SITENAME}} YourcmcWiki Имя сайта ($wgSitename)
{{SERVER}} https://yourcmc.ru URL домена($wgServer)
{{SERVERNAME}} yourcmc.ru доменное имя ($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}} /wiki относительный путь к скрипту ($wgScriptPath)
{{CURRENTVERSION}} 1.26.4 (adae689) Версия MediaWiki, на которой работает вики-проект. 1.7+
{{CONTENTLANGUAGE}} ru Язык интерфейса по умолчанию ($wgLanguageCode) 1.7+
Последняя правка статьи
{{REVISIONID}} 3989 Уникальный идентификатор правки
{{REVISIONDAY}} 26 День совершения правки (без ведущего нуля)
{{REVISIONDAY2}} 26 День совершения правки (с ведущим нулём)
{{REVISIONMONTH}} 03 Месяц совершения правки (без ведущего нуля)
{{REVISIONYEAR}} 2010 Год совершения правки
{{REVISIONTIMESTAMP}} 20100326211700 Дата совершения правки в формате ISO 8601
{{PAGESIZE:page name}} 56 Returns the byte size of the specified page. 1.13+
{{PROTECTIONLEVEL:action}} уровень защиты Регуляция уровня защиты (например, 'autoconfirmed', 'sysop') для определённого уровня (например, 'edit', 'move') на текущей странице, если таковая не защищена обычным способом. 1.15+
Воздействие на содержимое страницы
{{DISPLAYTITLE:title}} «Слово» позволяет изменять верхний заголовок страницы. Для полной работы этой функциональности требуется выключенная в LocalSettings.php переменная $wgAllowDisplayTitle; она была отключена до версии 1.10+ и включена во всех последующих версиях. 1.7+
{{DEFAULTSORT:sortkey}} Используется на страницах категорий, устанавливает ключ сортировки в категории по умолчанию. 1.10+

Статистика

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

Переменная Возвращаемое значение Описание Версия
По вики-проекту в целом
{{NUMBEROFPAGES}} 2335 Количество вики-страниц 1.7+
{{NUMBEROFARTICLES}} 248 Количество страниц в основном пространстве
{{NUMBEROFFILES}} 1267 Количество загруженных файлов 1.5+
{{NUMBEROFEDITS}} 14 100 Общее количество правок. 1.10+
{{NUMBEROFUSERS}} 1911 Количество зарегистрированных участников. 1.7+
{{NUMBEROFADMINS}} 4 Количество участников, входящих в группу sysop. См. права участников. 1.7+
{{NUMBERINGROUP:groupname}} 2
({{NUMBERINGROUP:bureaucrat}}, число бюрократов)
Число пользователей определённой группы. 1.14+
По пространствам имён

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

отключено Количество страниц в заданном пространстве имён (замените 2 на ID нужного пространства имён). Запрещено по умолчанию, разрешается через $wgAllowSlowParserFunctions. 1.7+
Разное
{{PAGESINCATEGORY:Help}} 1 Количество страниц в заданной категории (замените «Help» на имя нужной категории). 1.13+
{{PAGESINCAT:Help}} 1 Алиас для {{PAGESINCATEGORY}}. 1.13+
{{PAGESIZE:Help:Magic_words}} 56 Возвращает размер в байтах заданной страницы. 1.13+

Ссылки

Ссылки

Переменная Возвращаемое значение Описание Версия
{{SERVER}} https://yourcmc.ru Доменная ссылка ($wgServer)
{{SERVERNAME}} yourcmc.ru Имя домена ($wgServerName)
{{SCRIPTPATH}} /wiki Относительный путь к MediaWiki ($wgScriptPath)
{{localurl:название страницы}}
{{localurl:название страницы|строка запроса}}
/wiki/Pagename
/wiki/index.php?title=Pagename&query string
Относительный путь к странице
{{fullurl:page name}}
{{fullurl:page name|query_string}}
https://yourcmc.ru/wiki/Page_name
https://yourcmc.ru/wiki/index.php?title=Page_name&query_string
полная ссылка на страницу
{{filepath:file name}}
{{filepath:file name|nowiki}}

Полная ссылка на файл (есть ошибки с использованием nowiki) r25854
{{urlencode:x y z}} x+y+z Кодирование для URL-адреса. 1.7+
{{anchorencode:x y z}} x_y_z Кодирование URL после символа '#' (якорей). 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}} YourcmcWiki
{{ns:5}} или {{ns:Project_talk}} Обсуждение YourcmcWiki
{{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}} eo Имя языка по языковому коду. 1.7+
{{#special:userlogin}} Служебная:Вход Локализованное имя для служебных страниц. 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 позволяет создавать новые переменные, как часть расширения или отдельной инсталляции. Подробную информацию см. в Manual:Variable.