Help:Magic words/ru

From MediaWiki.org
Jump to: navigation, search
PD Внимание: Когда вы редактируете эту страницу, вы соглашаетесь на передачу вашего вклада в общественное достояние. Если вы не хотите или не можете этого сделать из-за лицензионных ограничений, то, пожалуйста, не редактируйте. Эта страница является одной из страниц справки в общественном достоянии, которые могут свободно копироваться во вновь создаваемые вики-проекты и/или распространяться с ПО MediaWiki; см. содержание справки со списком всех страниц. Инструкции по копированию справки в ваш вики-проект — на странице Project:PD help/Copying/ru. PD

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

Существуют три основных типа «волшебных слов»:

Странично-зависимые волшебные слова принимают или возвращают данные о текущей странице (по умолчанию), даже если слово добавляется через раскрываемый шаблон или включённое в текст системное сообщение.

Contents

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

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

Выражение Описание Версия
Содержание
__NOTOC__ Скрывает оглавление страницы (TOC).
__FORCETOC__ Заставляет содержание подниматься выше определённого уровня (в нулевой секции).
__TOC__ Размещает оглавление в текущую позицию (противоположно «слову» __ NOTOC __). Если используется _TOC_, то оглавление вернётся в исходное место на странице.
Редактирование
__NOEDITSECTION__ Скрывает ссылки «править» для каждой секции страницы. Это особенно полезно, когда заголовок создается из шаблона: нормальный вики-инструмент редактирования разделов в этом случае изменял бы код шаблона, что, как правило, выглядит для пользователя противоестественно. Если шаблон содержит несколько заголовков, может быть необходимым добавлять "__NOEDITSECTION__" после каждого из них.
__NEWSECTIONLINK__ Добавляет кнопку («+» по умолчанию) рядом с кнопкой «править» на любых страницах (см. m:Help:Section#Adding a section at the end). 1.7+
__NONEWSECTIONLINK__ Удаляет кнопку («+» по умолчанию) рядом с кнопкой «править» на страницах в пространствах «Обсуждение» 1.15+
Категории
__NOGALLERY__ Используется для категорий, в которые включено большое количество изображений. Это «слово» заменяет изображения на простые ссылки. 1.7+
__HIDDENCAT__ Используется в категории и позволяет скрыть эту категорию из более старших категорий (в которые включена данная категория) (более подробно — см. настройки участника). 1.13+
Преобразование языков
__NOCONTENTCONVERT__
__NOCC__
Запрещает выполнение языковой конвертации содержания на сайтах с языковыми вариантами. Например, будет отображён только китайский (zh), вместо таких вариантов, как zh_cn, zh_tw, zh_sg, или zh_hk.
__NOTITLECONVERT__
__NOTC__
Запрещает выполнение языковой конвертации заголовка на сайтах с языковыми вариантами (прочее содержание будет проходить конверсию).
Разное
__START__ Нет эффекта.
__END__ Обозначает конец страницы, не давая MediaWiki удалить её. Функция удалена, см. 19213. 1.1–1.8
__INDEX__ Позволяет поисковым системам индексировать страницу (переписывает $wgArticleRobotPolicies, но не robots.txt). 1.14+
__NOINDEX__ Запрещает индексацию страницы поисковыми системами (страница не будет отображена в результатах поиска). 1.14+
__STATICREDIRECT__ Помещённая на страницу перенаправления, запрещает MediaWiki автоматически исправлять двойные перенаправления. 1.13+

Переменные [edit]

Переменные возвращают сведения о текущей странице, вики-проекте или дате. Синтаксис большинства из них похож на синтаксис шаблонов. Переменные, помеченные как "[expensive]", отслеживаются движком, и возможное число их включений на одной странице ограничено.

Если имя шаблона совпадает с переменной, то вызывается переменная (так что для раскрытия шаблона Template:PAGENAME вам придётся написать {{Template:PAGENAME}}). В некоторых случаях добавление параметров может вызвать подключение шаблона; например, {{CURRENTDAYNAME|x}} приведёт к включению шаблона Template:CURRENTDAYNAME, а не значения одноимённой переменной.

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

Дата и время [edit]

Следующие переменные возвращают текущую дату и время в UTC (по Гринвичу).

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

Значения переменных даты и времени форматируются в зависимости от языковых настроек вики. Начиная с версии 1.19, они зависят от настройки языка конкретной страницы.

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

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

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

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

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

Функция Возвращаемое значение Описание Версия
Сайт
{{SITENAME}} MediaWiki Имя сайта ($wgSitename)
{{SERVER}} //www.mediawiki.org URL домена ($wgServer)
{{SERVERNAME}} www.mediawiki.org доменное имя ($wgServerName)
{{DIRMARK}}
{{DIRECTIONMARK}}

Выводит маркер направления Юникода, соответствующий направлению языка википроекта по умолчанию (‎ на сайтах с письменностью слева направо, ‏ - с письменностью справа налево), полезен в текстах с переменным направлением письма. 1.7+
{{SCRIPTPATH}} /w относительный путь к скрипту ($wgScriptPath)
{{STYLEPATH}} //bits.wikimedia.org/static-1.22wmf4/skins относительный путь к стилю ($wgStylePath) 1.16+
{{CURRENTVERSION}} 1.22wmf4 (8d74687) Версия MediaWiki, на которой работает вики-проект. 1.7+
{{CONTENTLANGUAGE}}
{{CONTENTLANG}}
en
en
Язык интерфейса по умолчанию ($wgLanguageCode) 1.7+
Page
{{PAGEID}} 13403 Возвращает идентификатор страницы. 1.20+
{{PAGESIZE:название страницы}}
{{PAGESIZE:название страницы|R}}
47,434
47434
[expensive] Возвращает размер указанной страницы в байтах. Для получения «сырого» числа (никак не отформатированного) используйте код параметр «R» ("|R"). 1.13+
{{PROTECTIONLEVEL:action}} Возвращает уровень защиты ('autoconfirmed', 'sysop') для заданного переменной действия ('edit', 'move') на текущей странице или пустую строку, если защита не установлена. 1.15+
Последняя правка статьи
{{REVISIONID}} 667207 Уникальный идентификатор правки 1.5+
{{REVISIONDAY}} 1 День совершения правки (без ведущего нуля) 1.8+
{{REVISIONDAY2}} 01 День совершения правки (с ведущим нулём) 1.8+
{{REVISIONMONTH}} 04 Месяц совершения правки (с ведущим нулём) 1.8+
{{REVISIONMONTH1}} 4 Месяц совершения правки (без ведущего нуля) 1.17+
{{REVISIONYEAR}} 2013 Год совершения правки 1.8+
{{REVISIONTIMESTAMP}} 20130401183151 Дата совершения правки в формате ISO 8601 1.8+
{{REVISIONUSER}} Kaganer Имя участника, сделавшего последнюю правку на странице или участника, который предварительно просматривает страницу перед записью в данный момент 1.15+
Воздействие на содержимое страницы
{{DISPLAYTITLE:title}} Позволяет изменять верхний заголовок текущей страницы. Значение должно быть эквивалентно заголовку по умолчанию, можно только изменять произвольно заглавные буквы и заменять пробелы подчёркиваниями (это поведение можно изменить с помощью $wgRestrictDisplayTitle). Для полной работы этой функциональности требуется выключенная в LocalSettings.php переменная $wgAllowDisplayTitle; она была отключена до версии 1.10+ и включена во всех последующих версиях. 1.7+
{{DEFAULTSORT:sortkey}}
{{DEFAULTSORTKEY:sortkey}}
{{DEFAULTCATEGORYSORT:sortkey}}
{{DEFAULTSORT:sortkey|noerror}}
{{DEFAULTSORT:sortkey|noreplace}}
Устанавливает ключ сортировки страницы во всех её категориях по умолчанию. Например, если поставить {{DEFAULTSORT:Smith, John}} в конц страницы John Smith, страница по умолчанию в категориях будет отсортировываться в разделе на букву "S". Может быть передан второй аргумент noerror или noreplace для подавления сообщений об ошибках, если даны несколько ключей по умолчанию на одной странице, или чтобы ключ не учитывался, если уже есть другие. 1.10+
1.19+ (для noerror и noreplace)

Статистика [edit]

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

Числовые значения переменных форматируются в зависимости от языковызх настроек вики. Начиная с версии 1.19, они зависят от настройки языка конкретной страницы.

Функция Возвращаемое значение Описание Версия
По вики-проекту в целом
{{NUMBEROFPAGES}} 89,994 Количество вики-страниц. 1.7+
{{NUMBEROFARTICLES}} 10,487 Количество страниц в основном пространстве.
{{NUMBEROFFILES}} 2,087 Количество загруженных файлов. 1.5+
{{NUMBEROFEDITS}} 735,940 Общее количество правок. 1.10+
{{NUMBEROFVIEWS}} Общее количество просмотров страниц. Обычно бесполезно для вики, использующих кеширование. 1.14+
{{NUMBEROFUSERS}} 905,808 Количество зарегистрированных участников. 1.7+
{{NUMBEROFADMINS}} 125 Количество участников в группе sysop. 1.7+
{{NUMBEROFACTIVEUSERS}} 939 Количество активных участников, на основании критериев, используемых в Special:Statistics. 1.15+
{{PAGESINCATEGORY:categoryname}}
{{PAGESINCAT:categoryname}}
77
77
[expensive] Число страниц (включая подкатегории и файлы) в заданной категории. 1.14+
{{PAGESINCATEGORY:categoryname|all}}
{{PAGESINCATEGORY:categoryname|pages}}
{{PAGESINCATEGORY:categoryname|subcats}}
{{PAGESINCATEGORY:categoryname|files}}
77
75
2
0
[expensive] Соответственно, количество
  • всех страниц
  • обычных страниц (включая подкатегории и файлы)
  • подкатегорий или
  • файлов

в заданной категории.

1.20+
{{NUMBERINGROUP:groupname}}
{{NUMINGROUP:groupname}}
27
27
({{NUMBERINGROUP:bureaucrat}} used here)
Число пользователей определённой группы. 1.14+
{{PAGESINNS:номер}}
{{PAGESINNAMESPACE:номер}}
отключено Количество страниц в заданном пространстве имён (замените номер на ID нужного пространства имён). Например, {{PAGESINNAMESPACE:14}} позволит вывести число категорий. {{PAGESINNS:0}} отличается от {{NUMBEROFARTICLES}} тем, что первое включает перенаправления и страницы разрешения неоднозначностей. Отключено по умолчанию, включается через $wgAllowSlowParserFunctions. 1.7+

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

Переменная Возвращаемое значение Описание Версия
{{FULLPAGENAME}} Help:Magic words/ru Пространство статей и название страницы 1.6+
{{PAGENAME}} Magic words/ru Название страницы.
{{BASEPAGENAME}} Magic words Название страницы без текущей подстраницы и без указания пространства статей («Статья» на «Статья/test»).

Для более сложного расщепления, используйте функцию {{#titleparts:}} из расширения ParserFunctions.

1.7+
{{SUBPAGENAME}} ru Название подстраницы («test» на «Страница/test») 1.6+
{{SUBJECTPAGENAME}}
{{ARTICLEPAGENAME}}
Help:Magic words/ru
Help:Magic words/ru
Пространство имён и название основной страницы, ассоцииорованной с текущей (или указанной) страницей обсуждения. Пример: {{SUBJECTPAGENAME:Help talk:Magic words}} вернёт «Help:Magic words». 1.7+
{{TALKPAGENAME}} Help talk:Magic words/ru Название страницы обсуждения, ассоцииорованной с текущей (или указанной) страницей 1.7+

Переменные {{BASEPAGENAME}} и {{SUBPAGENAME}} работают только для пространств имён, в которых включены подстраницы. См. Manual:$wgNamespacesWithSubpages, чтобы узнать о включении подстраниц.

URL-кодирование названий страниц [edit]

Также есть эквиваленты для использования в URL-адресах страниц MediaWiki (со знаками подчёркивания вместо пробелов и с URL-кодированием некоторых символов или заменой на числовые коды HTML):

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

Например, для страницы с названием "L'Aquila" следующий код отобразит "Numeric char encoding":

{{#switch:{{PAGENAME}}
|L'Aquila = No translation
|L = not ok
|L'Aquila = Entity Escaping
|L'Aquila = Numeric char encoding
}}

(См. баг 35628 с более детальной информацией).

Начиная с версии 1.15+, все эти переменные могут принимать параметр, позволяющий указать название страницы, отличающейся от текущей:

  • {{PAGENAME:Template:Main Page}}Main Page
Внимание Внимание:   Заголовки страниц, содержащие некоторые символы, среди которых одинарная кавычка (')и астериск *, могут при обработке данными конструкциями выдавать неожиданные результаты, e.g. {{PAGESINCATEGORY:{{PAGENAME}}}}. См. баги 14779, 16474.

Заметьте, что {{PAGENAME}}, {{PAGENAMEE}} и {{urlencode:}} Реализованы по-разному. Подробнее см. в Manual:PAGENAMEE encoding.

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

Переменная Возвращаемое значение Описание Версии
{{NAMESPACE}} Help Пространство имён (название)
{{NAMESPACENUMBER}} 12 Номер пространства имён 1.20+
{{SUBJECTSPACE}}
{{ARTICLESPACE}}
Help
Help
Пространство имён для текущей статьи 1.7+
{{TALKSPACE}} Help talk Пространство имён для текущей страницы обсуждения 1.7+

Эквиваленты с URL-кодированием (со знаками подчёркивания вместо пробелов и с URL-кодированием некоторых символов):

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

Начиная с версии 1.15+, эти функции могут в качестве параметра принимать полное имя любой страницы и возвращать пространства имён для неё:

  • {{NAMESPACE:Template:Main Page}}Template
  • {{SUBJECTSPACE:Template:Main Page}}Template
  • {{TALKSPACE:Template:Main Page}}Template talk

Параметр не должен совпадать с названием пространства имён:

  • {{SUBJECTSPACE:Help talk}} → '

Функции парсера [edit]

Ссылки [edit]

Функция Возвращаемое значение Описание Версия
{{localurl:pagename}}
{{localurl:pagename|query}}
/wiki/Pagename
/w/index.php?title=Pagename&query
Относительный путь к странице
{{fullurl:pagename}}
{{fullurl:pagename|query}}
//www.mediawiki.org/wiki/Pagename
//www.mediawiki.org/w/index.php?title=Pagename&query
Полная ссылка на страницу
{{filepath:file name}}
{{filepath:file name|nowiki}}
//upload.wikimedia.org/wikipedia/mediawiki/b/bc/Wiki.png
//upload.wikimedia.org/wikipedia/mediawiki/b/bc/Wiki.png
Полная ссылка на файл (есть ошибки с использованием nowiki) r25854
{{urlencode:x y z}} x+y+z Кодирование для URL-адреса 1.7+
{{anchorencode:x y z}} x_y_z Кодирование URL после символа '#' (якорей) 1.8+

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

{{ns:}} возвращает локализованное название пространства имён для указанного числа или константы. {{nse:}} возвращает то же самое, но в формате URL-адреса MediaWiki, где пробелы заменены символом подчёркивания, что позволяет использовать их во внешних ссылках. Значения по умолчанию:

Содержательные пространства имён Пространства имён обсуждений
Использование Возвращаемое значение Использование Возвращаемое значение
{{ns:-2}} или {{ns:Media}} Media
{{ns:-1}} или {{ns:Special}} Special
{{ns:0}} или {{ns:}} {{ns:1}} или {{ns:Talk}} Talk
{{ns:2}} или {{ns:User}} User {{ns:3}} или {{ns:User_talk}} User talk
{{ns:4}} или {{ns:Project}} Project {{ns:5}} или {{ns:Project_talk}} Project talk
{{ns:6}} или {{ns:Image}} File {{ns:7}} или {{ns:Image_talk}} File talk
{{ns:8}} или {{ns:MediaWiki}} MediaWiki {{ns:9}} или {{ns:MediaWiki_talk}} MediaWiki talk
{{ns:10}} или {{ns:Template}} Template {{ns:11}} или {{ns:Template_talk}} Template talk
{{ns:12}} или {{ns:Help}} Help {{ns:13}} или {{ns:Help_talk}} Help talk
{{ns:14}} или {{ns:Category}} Category {{ns:15}} или {{ns:Category_talk}} Category talk

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

Функция Возвращаемое значение Описание Версия
{{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+

Локализация [edit]

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

В ряде языковых версий Википедии (русская, белорусская, польская) эта функция настроена так, что позволяет использовать 3 параметра, а для определения формы слова используется остаток от деления на 100. В результате не только

{{plural:1|слово|слова|слов}}=слово

и

{{plural:2|слово|слова|слов}}=слова

, но и

{{plural:5|слово|слова|слов}}=слов

На http://www.mediawiki.org 3-й параметр функции «plural» не работает, так что

{{plural:5|слово|слова|слов}}=слова
{{grammar:N|существительное}} Выводит заданное слово в правильной грамматической форме (склонении, падеже), согласно коду грамматической формы, указанному после двоеточия (зависит от языка). Грамматическая трансформация используется во флексивных языках, таких как польский, русский и т.п. См. также Manual:$wgGrammarForms. 1.7+
{{gender:username
|текст, если участник мужчина
|текст, если участница женщина
|текст, если участник не определил в настройках свой пол}}
(в зависимости от того, что участник username указал в своих настройках в качестве пола) Возвращает соответственно мужчина, женщина или не установлено для учётной записи username в соответствии с его персональными настройками.

Замечание: Если третий параметр не указан и участник/участница явно не задал(а) в настройках признак половой принадлежности, выводится текст, если участник мужчина.

1.15+
{{int:message name}} {{int:edit}}Edit
(depends on user language; try: frja)
Internationalizes (translates) the given interface (MediaWiki namespace) message into the user language. For msgnw and other transclusion magic words, see m:Help:Magic words#Template modifiers.

Note that this can damage / confuse cache consistency in MediaWiki 1.17 and earlier, see bug 14404.

{{int:editsectionhint|MediaWiki}} {{int:editsectionhint|MediaWiki}}Edit section: MediaWiki You may also use parameters with translations.
Parameters are designated in messages with: $1, $2, $3, etc.
For example, here is the message for editsectionhint: Edit section: $1
In this example, MediaWiki replaces $1.

Прочее [edit]

Функция Возвращаемое значение Описание Версия
{{#language:en}}
{{#language:ru}}
{{#language:th}}
English
русский
ไทย
Имя языка по языковому коду на собственном языке в соответствии с ISO 639. 1.7+
{{#special:userlogin}} Special:UserLogin Локализованное имя для служебных страниц. 1.9+
{{#speciale:special page name}}
{{#speciale:userlogin}}
No_such_special_page
Special:UserLogin
Локализованное и URL-кодированное имя от канонического имени служебной страницы. 1.20+
{{#tag:tagname}}
{{#tag:tagname|inner content|parameter=value|parameter2=value}}
(зависит от тэга tagname) Альтернатива тэгам парсера или расширений. Внутри него вики-код и функции парсера могут быть выполнены до того, как будет обработан тэг. Тэг не будет обработан в не исполняемых ветвях условных конструкций типа {{#if}}. Значения атрибутов можно передать, как значения параметров ('<tagname attribute="value">' → '{{#tag:tagname|attribute=value}}'), а внутреннее содержание — как безымянный параметр ('<tagname>content</tagname>' → '{{#tag:tagname|content}}'). Для передачи пустого содержимого тэга этот параметр не должен содержать между ветикальными частями ничего, даже пробелов. 1.12+

Собственные переменные [edit]

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

Язык: English  • dansk • Deutsch • Zazaki • español • فارسی • français • Bahasa Indonesia • 日本語 • 한국어 • मराठी • português • português do Brasil • русский • slovenčina • Türkçe