Help:Magic words/ru
From MediaWiki.org
 |
Внимание: Когда вы редактируете эту страницу, вы соглашаетесь на передачу вашего вклада в общественное достояние. Если вы не хотите или не можете этого сделать из-за лицензионных ограничений, то, пожалуйста, не редактируйте. Эта страница является одной из страниц справки в общественном достоянии, которые могут свободно копироваться в свежие установки вики и/или распространяться с ПО MediaWiki. См. содержание справки для обзора всех страниц. |
«Волшебные слова» в MediaWiki — комбинации текста, управляющие поведением, оформлением той или иной страницы в вики, а также выводящие некоторые полезные переменные из базы данных. Более подробную техническую информацию см. в Manual:Magic words.
Contents |
[edit] Основные замечания
- Наследование: переменные и «магические выражения», зависящие от страницы, возвращают значения в зависимости от просматриваемой страницы, независимо от того, присутствуют они в коде страницы или включены через другую страницу.
[edit] Переключатели поведения
Переключатели поведения — «волшебные слова», влияющие на оформление страниц в вики.
| Выражение | Описание | Версия |
|---|---|---|
| Содержание | ||
| __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]] | Перенаправляет с текущей страницы на другую. | |
[edit] Переменные
Синтаксис большинства переменных похож на синтаксис шаблонов, но для избежания конфликтов обычно использует только заглавные буквы. Если имя шаблона совпадает с переменной, то вызывается переменная; для принудительного вызова шаблона используйте префикс msg:, например {{msg:CURRENTYEAR}}. В некоторых случаях, добавление параметров может вызвать подключение шаблона; например, {{CURRENTDAYNAME|x}} приведёт в включению шаблона «Шаблон:CURRENTDAYNAME».
Функции парсера похожи на переменные, но срабатывают на месте ввода, а не на всей странице. Первый параметр отделён двоеточием (:), а не вертикальным слэшем (|). (На этой странице не описаны функции расширения ParserFunctions extension.)
[edit] Дата и время
Следующие переменные возвращают текущую дату и время, основываясь на часовом поясе пользователя, указанном в настройках. Часовой пояс по умолчанию — UTC.
Вследствие кэширования страниц браузером и MediaWiki, эти переменные часто показывают когда страница была закэширована, вместо отображения текущего времени.
| Переменная | Возвращаемое значение | Описание | Версия |
|---|---|---|---|
| Год | |||
| {{CURRENTYEAR}} | 2008 | Год | |
| Текущий месяц | |||
| {{CURRENTMONTH}} | 12 | Месяц (число) | |
| {{CURRENTMONTHNAME}} | December | Текущий месяц (название) | |
| {{CURRENTMONTHNAMEGEN}} | December | Текущий месяц (в родительном падеже) | |
| {{CURRENTMONTHABBREV}} | Dec | Текущий месяц (аббревиатура) | 1.5+ |
| День | |||
| {{CURRENTDAY}} | 5 | День месяца (1..31) | |
| {{CURRENTDAY2}} | 05 | День месяца (с ведущим нулём: 01..31) | 1.6+ |
| {{CURRENTDOW}} | 5 | День недели (число) | |
| {{CURRENTDAYNAME}} | Friday | День недели (название) | |
| Время | |||
| {{CURRENTTIME}} | 15:00 | Текущее время (24-часовой формат — HH:mm) | |
| {{CURRENTHOUR}} | 15 | Час (01..24) | |
| Разное | |||
| {{CURRENTWEEK}} | 49 | Текущая неделя (число) | |
| {{CURRENTTIMESTAMP}} | 20081205150025 | Время по стандарту ISO 8601 | 1.7+ |
Следующие переменные возвращают подобные значения, что и выше, но используют локальный часовой пояс, не зависимо от настроек пользователя и UTC:
- {{LOCALYEAR}}
- {{LOCALMONTH}}
- {{LOCALMONTHNAME}}
- {{LOCALMONTHABBREV}}
- {{LOCALDAY}}
- {{LOCALDAY2}}
- {{LOCALDOW}}
- {{LOCALDAYNAME}}
- {{LOCALTIME}}
- {{LOCALHOUR}}
- {{LOCALWEEK}}
- {{LOCALTIMESTAMP}}
[edit] Технические метаданные
Следующие переменные возвращают значения, связанные с последней правкой текущей статьи, независимо от просматриваемой версии.
| Переменная | Возвращаемое значение | Описание | Версия |
|---|---|---|---|
| Сайт | |||
| {{SITENAME}} | MediaWiki | Имя сайта ($wgSitename) | |
| {{CURRENTVERSION}} | 1.14alpha (r43634) | Версия MediaWiki, на которой работает вики-проект. | 1.7+ |
| {{CONTENTLANGUAGE}} | en | Язык интерфейса по умолчанию ($wgLanguageCode) | |
| Последняя правка статьи | |||
| {{REVISIONID}} | 217059 | Уникальный идентификатор правки | |
| {{REVISIONDAY}} | 6 | День совершения правки (без ведущего нуля) | |
| {{REVISIONDAY2}} | 06 | День совершения правки (с ведущим нулём) | |
| {{REVISIONMONTH}} | 10 | Месяц совершения правки (без ведущего нуля) | |
| {{REVISIONYEAR}} | 2008 | Год совершения правки | |
| {{REVISIONTIMESTAMP}} | 20081006104319 | Дата совершения правки в формате ISO 8601 | |
[edit] Статистика
Числа, возвращаемые этими переменными, содержат разделители разрядов. Для получения неотформатированных чисел используется флаг «:R» (например, {{NUMBEROFPAGES}} = 16,611 и {{NUMBEROFPAGES:R}} = 16611). Для волшебных слов, требующих параметра, таких как PAGESINCATEGORY, используйте «|R» (например, {{PAGESINCATEGORY:Help}} и {{PAGESINCATEGORY:Help|R}}).
| Переменная | Возвращаемое значение | Описание | Версия |
|---|---|---|---|
| По вики-проекту в целом | |||
| {{NUMBEROFPAGES}} | 16,611 | Количество вики-страниц | 1.7+ |
| {{NUMBEROFARTICLES}} | 3,625 | Количество страниц в основном пространстве | |
| {{NUMBEROFFILES}} | 572 | Количество загруженных файлов | 1.5+ |
| {{NUMBEROFEDITS}} | 230,802 | Общее количество правок. | 1.10+ |
| {{NUMBEROFUSERS}} | 79,785 | Количество зарегистрированных участников. | 1.7+ |
| {{NUMBEROFADMINS}} | 46 | Количество участников, входящих в группу sysop. См. права участников. | 1.7+ |
| {{NUMBERINGROUP:groupname}} | 15 ({{NUMBERINGROUP:bureaucrat}}, число бюрократов) |
Число пользователей определённой группы. | 1.14+ |
| По пространствам имён | |||
| {{PAGESINNS:2}} | Template:PAGESINNS:2 | Количество страниц в заданном пространстве имён (замените 2 на ID нужного пространства имён). Запрещено по умолчанию, разрешается через $wgAllowSlowParserFunctions. | 1.7+ |
| {{PAGESINNAMESPACE:2}} | Template:PAGESINNAMESPACE:2 | Алиас для {{PAGESINNS}}. |
1.7+ |
| Разное | |||
| {{PAGESINCATEGORY:Help}} | 43 | Количество страниц в заданной категории (замените «Help» на имя нужной категории). | 1.13+ |
| {{PAGESINCAT:Help}} | 43 | Алиас для {{PAGESINCATEGORY}}. |
1.13+ |
| {{PAGESIZE:Help:Magic_words}} | 18,884 | Возвращает размер в байтах заданной страницы. | 1.13+ |
[edit] Ссылки
[edit] Ссылки
| Переменная | Возвращаемое значение | Описание | Версия |
|---|---|---|---|
| {{SERVER}} | http://www.mediawiki.org | Доменная ссылка ($wgServer) | |
| {{SERVERNAME}} | www.mediawiki.org | Имя домена ($wgServerName) | |
| {{SCRIPTPATH}} | /w | Относительный путь к MediaWiki ($wgScriptPath) | |
| {{localurl:название страницы}} {{localurl:название страницы|строка запроса}} |
/wiki/Pagename /w/index.php?title=Pagename&query string |
Относительный путь к странице | |
| {{fullurl:page name}} {{fullurl:page name|query_string}} |
http://www.mediawiki.org/wiki/Page_name http://www.mediawiki.org/w/index.php?title=Page_name&query_string |
полная ссылка на страницу | |
| {{filepath:file name}} {{filepath:file name|nowiki}} |
http://upload.wikimedia.org/wikipedia/mediawiki/b/bc/Wiki.png <nowiki>http://upload.wikimedia.org/wikipedia/mediawiki/b/bc/Wiki.png</nowiki> |
Полная ссылка на файл (есть ошибки с использованием nowiki) | r25854 |
| {{urlencode:x y z}} | x+y+z |
Кодирование для URL-адреса. | 1.7+ |
| {{anchorencode:x y z}} | x_y_z |
Кодирование URL после символа '#' (якорей). | 1.8+ |
[edit] Названия страниц
| Переменная | Возвращаемое значение | Описание | Версия |
|---|---|---|---|
| {{FULLPAGENAME}} | Help:Magic words/ru | Пространство статей и название страницы | |
| {{BASEPAGENAME}} | Magic words | Название страницы без текущей подстраницы и без указания пространства статей («Статья» на «Статья/test») | |
| {{PAGENAME}} | Magic words/ru | Название страницы | 1.7+ |
| {{SUBPAGENAME}} | ru | Название подстраницы («test» на «Страница/test») | 1.6+ |
| {{SUBJECTPAGENAME}} | Help:Magic words/ru | Название основной страницы статьи. | 1.7+ |
| {{TALKPAGENAME}} | Help talk:Magic words/ru | Название страницы обсуждения статьи | 1.7+ |
Эквиваленты с URL-кодированием:
- {{FULLPAGENAMEE}}
- {{PAGENAMEE}}
- {{BASEPAGENAMEE}}
- {{SUBPAGENAMEE}}
- {{SUBJECTPAGENAMEE}}
- {{TALKPAGENAMEE}}
[edit] Пространство имён
| Переменная | Возвращаемое значение | Описание |
|---|---|---|
| {{NAMESPACE}} | Help | Пространство имён (название) |
| {{SUBJECTSPACE}} | Help | Пространство имён для текущей статьи |
| {{TALKSPACE}} | Help talk | Пространство имён для текущей страницы обсуждения |
Эквиваленты с URL-кодирование:
- {{NAMESPACEE}}
- {{SUBJECTSPACEE}}
- {{TALKSPACEE}}
{{ns:}} возвращает локализованное название пространства имён для указанного числа или константы. Значения по умолчанию:
| Использование | Возвращаемое значение |
|---|---|
| {{ns:-2}} или {{ns:Media}} | Media |
| {{ns:-1}} или {{ns:Special}} | Special |
| {{ns:0}} или {{ns:Main}} | |
| {{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}} | Image |
| {{ns:7}} или {{ns:Image_talk}} | Image 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+ |
| {{plural:2|is|are}} | are | Выводит форму множественного числа (исключая первый параметр) в зависимости от числа (первый параметр). Например, для определения множественного числа в русском языке используется остаток от деления на 10. |
[edit] Прочее
| Переменная | Возвращаемое значение | Описание | Версия |
|---|---|---|---|
| {{#language:eo}} | Esperanto | Имя языка по языковому коду. | 1.7+ |
| {{#special:userlogin}} | 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+ |
[edit] Собственные переменные
MediaWiki позволяет создавать новые переменные, как часть расширения или отдельной инсталляции. Подробную информацию см. в Manual:Variable.
