 |
Зверніть увагу! Коли Ви редагуєте цю сторінку, то погоджуєтесь робити свій внесок під ліцензією CC0. Детальніше про умови ліцензії можна дізнатися на сторінці довідки.
|
|
Магічними словами називають певні комбінації символів, яким MediaWiki зіставляє певне значення чи функцію - час, назву сторінки, сайту тощо. Ця стаття пояснює лише стандартні магічні слова; детальніший опис див. у відповідному розділі технічного посібника.
Розрізнюють три загальні типи магічних слів:
- Перемикачі поведінки: зазвичай складені з літер верхнього регістру та двох символів підкреслення по боках, як-от __FOO__.
- Змінні: слова в подвійних фігурних дужках, складені з літер верхнього регістру, як-от
{{FOO}}. Виглядають певною мірою схожими на шаблони.
Змінні та функції парсера здатні використовувати підстановку subst:, подібно до шаблонів. Магічні слова, призначені для роботи зі сторінкою, змінюють чи повертають дані про поточну сторінку (якщо в параметрах явно не вказано інше), навіть коли вони включені з шаблону чи системного повідомлення.
Перемикачі поведінки
Перемикачі поведінки управляють виглядом чи поведінкою сторінки вікі і часто використовуються для включення певних блоків інформації до її тексту.
| Слово
|
Опис
|
Версії
|
| Зміст
|
__NOTOC__
|
Приховує зміст.
|
|
__FORCETOC__
|
Примусово показує зміст на його звичайній позиції (перед першим заголовком).
|
|
__TOC__
|
Показує зміст в місці розташування цього слова (має пріоритет над __NOTOC__). Ефект має тільки однократне використання, повтори на тій самій сторінці ігноруються.
|
|
| Редагування
|
__NOEDITSECTION__
|
Приховує посилання для редагування розділу, що зазвичай стоїть біля його заголовка. Особливо корисне, коли заголовок включено із шаблону. В такому випадку звичайне редагування розділу змінюватиме код шаблону, це - зазвичай не очікувана користувачем поведінка. Якщо шаблон містить кілька заголовків, може бути необхідним додати "$noeditsection" після кожного заголовка. Use of this in a template will extend the effect to that template, the pages it's included on, and any other templates included on the same page. For a workaround, see here.
|
|
__NEWSECTIONLINK__
|
Поруч із вкладкою "Edit" додає вкладку для створення нового розділу на звичайних сторінках (подібно до сторінок обговорення), див. Додавання розділу наприкінці статті.
|
|
__NONEWSECTIONLINK__
|
Для сторінок обговорення приховує вкладку поряд із "Edit", яка дозволяє швидко додати новий розділ наприкінці сторінки обговорення.
|
|
| Категорії
|
__NOGALLERY__
|
На сторінці категорії замінює ескізи зображень звичайними текстовими посиланнями.
|
|
__HIDDENCAT__
|
На сторінці категорії: приховує цю категорію від внесення у покажчик категорій батьківських категорій та категоризованих сторінок (користувач може це заборонити за допомогою власних налаштувань).
|
|
| Мовні перетворення
|
__NOCONTENTCONVERT__
__NOCC__
|
Забороняє будь-які мовні перетворення вмісту для мовних варіантів на сторінці, для тих вікі-проектів, які мають мовні варіанти сторінок. Так, приміром, буде використана основна мова китайська (zh) замість її варіантів zh_cn, zh_tw, zh_sg, zh_hk тощо.
|
|
__NOTITLECONVERT__
__NOTC__
|
Забороняє мовні перетворення лише назв сторінок для тих вікі проектів, які мають мовні варіанти сторінок.
|
|
| Інше
|
__START__
|
No effect. Was used to point where database message starts after comment that should not be transcluded. Removed in r1695 and completely removed in r24784
|
|
__END__
|
Явно визначає кінець статті, не дозволяючи рушію MediaWiki відкинути кінцеві порожні рядки. Вилучено в 19213.
|
|
__INDEX__
|
Дозволяє пошуковим системам індексувати сторінку (має пріоритет над $wgArticleRobotPolicies, але не над robots.txt). Підкоряється налаштуванню $wgExemptFromUserRobotsControl.
|
|
__NOINDEX__
|
Забороняє пошуковим системам індексувати сторінку (сторінка не може виринути в результатах пошуку цих систем). Підкоряється налаштуванню $wgExemptFromUserRobotsControl.
|
|
__STATICREDIRECT__
|
На сторінках перенаправлення: не дозволяє MediaWiki автоматично оновити посилання у випадку, коли дописувач переносить сторінку і вмикає прапорець "Виправити всі перенаправлення на попередню назву" (що потребує $wgFixDoubleRedirects).
|
|
__NOGLOBAL__
|
Disables the global user page. If present on the central user page, will prevent it from being displayed on remote wikis, and it also determines whether a link to a user page on remote wiki should be red or blue.
|
|
Змінні
Змінні надають інформацію про поточну сторінку, вікі, дату тощо. Їх використання синтаксично подібне до шаблонів. Використання змінних із позначкою "[Витратна]" контролюється рушієм MediaWiki, і кількість таких використань на одній сторінці може бути обмеженою.
Якщо назва шаблону збігається із назвою змінної, пріоритет має змінна. Для розгортання, приміром, такого шаблону Template:PAGENAME вам доведеться написати {{Template:PAGENAME}}. Але в деяких випадках вказаний параметр примусить парсер підключити шаблон; приміром, {{CURRENTDAYNAME|x}} звертається до Template:CURRENTDAYNAME, не до однойменної змінної.
Дата і час
Наступні змінні дають поточну дату і час за Гринвічем (UTC).
Внаслідок кешування MediaWiki і веб-оглядача, ці змінні дають час останнього кешування сторінки замість поточного.
Формат отриманих дати й часу залежить від мови вмісту вікі-проекту. Починаючи з MW 1.19, цей формат визначається мовою сторінки.
| Змінна
|
Її отримане значення
|
Опис
|
Версії
|
| Рік
|
{{CURRENTYEAR}}
|
2018
|
Рік
|
|
| Місяць
|
{{CURRENTMONTH}}
|
05
|
Місяць (число, при необхідності доповнене нулем)
|
|
{{CURRENTMONTH1}}
|
5
|
Month (unpadded number)
|
|
{{CURRENTMONTHNAME}}
|
травень
|
Місяць (назва)
|
|
{{CURRENTMONTHNAMEGEN}}
|
травня
|
Місяць (в родовому відмінку)
|
|
{{CURRENTMONTHABBREV}}
|
трав
|
Місяць (скорочення)
|
|
| День
|
{{CURRENTDAY}}
|
20
|
День місяця (число без вирівнювання ширини)
|
|
{{CURRENTDAY2}}
|
20
|
День місяця (число, при необхідності доповнене нулем)
|
|
{{CURRENTDOW}}
|
0
|
День тижня (число), від 0 (неділя) до 6 (субота)
|
|
{{CURRENTDAYNAME}}
|
неділя
|
День тижня (назва)
|
|
| Час
|
{{CURRENTTIME}}
|
09:11
|
Час (24-годинний формат HH:mm)
|
|
{{CURRENTHOUR}}
|
09
|
Час (24-годинний формат, число, при необхідності доповнене нулем)
|
|
| Інше
|
{{CURRENTWEEK}}
|
20
|
Тиждень (число)
|
|
{{CURRENTTIMESTAMP}}
|
20180520091155
|
Часова мітка YYYYMMDDHHmmss (відповідно до стандарту ISO 8601)
|
|
Наступні змінні мають той самий сенс, що й вищезгадані, але використовують налаштування сервера чи $wgLocaltimezone, незалежно від особистих налаштувань користувача.
{{LOCALYEAR}}{{LOCALMONTH}}{{LOCALMONTH1}}{{LOCALMONTHNAME}}{{LOCALMONTHNAMEGEN}}{{LOCALMONTHABBREV}}{{LOCALDAY}}{{LOCALDAY2}}{{LOCALDOW}}{{LOCALDAYNAME}}{{LOCALTIME}}{{LOCALHOUR}}{{LOCALWEEK}}{{LOCALTIMESTAMP}}
Для різноманітніших варіантів форматування дати й часу вам знадобиться функція #time parser function розширення Extension:ParserFunctionsExtension:ParserFunctions.
Технічні метадані
Примітка: Значення змінних, що стосуються версії сторінки, завжди пов'язані з останнім редагуванням сторінки, навіть якщо ви переглядаєте старішу її версію.
| Змінна
|
Її отримане значення
|
Опис
|
Версії
|
| Сайт
|
{{SITENAME}}
|
MediaWiki
|
Назва сайту вікі-проекту ($wgSitename).
|
|
{{SERVER}}
|
//www.mediawiki.org
|
URL-адреса домену ($wgServer)
|
|
{{SERVERNAME}}
|
www.mediawiki.org
|
Піддомен та доменне ім'я (починаючи з MW 1.17 не залежить від $wgServerName).
|
|
{{DIRMARK}}
{{DIRECTIONMARK}}
|
|
Виводить символ Юнікоду для напрямку запису тексту, що відповідає напрямку тексту за замовчуванням для даного вікі-проекту (‎ зліва направо, ‏ справа наліво). Корисно в текстах зі змінним напрямком запису. Починаючи з версії 1.19, залежить від мови сторінки.
|
|
{{SCRIPTPATH}}
|
/w
|
Відносний шлях до файлів сценарію ($wgScriptPath).
|
|
{{STYLEPATH}}
|
/w/skins
|
Відносний шлях до файлів стилю ($wgStylePath).
|
|
{{CURRENTVERSION}}
|
1.32.0-wmf.4 (54379d4)
|
Версія рушію MediaWiki даного вікі-проекту.
|
|
{{CONTENTLANGUAGE}}
{{CONTENTLANG}}
|
en
en
|
Мова інтерфейса по замовчуванню ($wgLanguageCode).
|
|
| Сторінка
|
{{PAGEID}}
|
298313
|
Повертає ідентифікатор сторінки.
|
|
{{PAGELANGUAGE}}
{{#language:{{PAGELANGUAGE}}}}
|
uk
українська
|
Returns the language of the current page. The language code that this variable returns can be converted to a language name using {{#language:...}}.
|
|
{{PROTECTIONLEVEL:дія}}
|
|
Повертає необхідний рівень дозволів (e.g. "autoconfirmed", "sysop") для заданої дії (Edit, Move тощо) на поточній сторінці, або порожній рядок для незахищеної сторінки.
|
|
{{PROTECTIONEXPIRY:action}}
|
|
Outputs the protection expiry (e.g. "20160418155030", "infinity") for a given action (e.g. "edit", "move") on the current page. Returns "infinity" if not protected.
|
|
{{CASCADINGSOURCES}}
|
|
[Expensive] [Витратна] Повертає перелік джерел каскадного захисту, активних для поточної сторінки. Цей перелік не вміщуватиме назву поточної сторінки, якщо та не містить команд включення до свого тексту власних частин.
|
|
| Остання зміна поточної статті
|
{{REVISIONID}}
|
2716287
|
Унікальний ідентифікатор зміни.
|
|
{{REVISIONDAY}}
|
16
|
День, коли зміна відбулася (число без вирівнювання ширини).
|
|
{{REVISIONDAY2}}
|
16
|
День, коли зміна відбулася (число, при необхідності доповнене нулем).
|
|
{{REVISIONMONTH}}
|
02
|
Місяць, коли зміна відбулася (число; при необхідності доповнене нулем - починаючи з версії1.17+; без вирівнювання ширини - для старіших версій).
|
|
{{REVISIONMONTH1}}
|
2
|
Місяць, коли зміна відбулася (число без вирівнювання ширини).
|
|
{{REVISIONYEAR}}
|
2018
|
Рік, коли зміна відбулася.
|
|
{{REVISIONTIMESTAMP}}
|
20180216230843
|
Часова мітка останньої зміни.
|
|
{{REVISIONUSER}}
|
Renamerr
|
Ім'я користувача, якому належить остання зміна; поточного користувача при попередньому перегляді редагованої сторінки.
|
|
{{REVISIONSIZE}}
|
89879
|
Розмір (байтів вікітексту) поточної версії сторінки.
|
|
| Впливають на вміст сторінки
|
{{DISPLAYTITLE:назва|noreplace}}
|
|
Дозволяє модифікувати відображуваний заголовок вищого рівня. Назва має бути еквівалентною назві сторінки: дозволяються зміни в регістрі літер та взаємозамінювання пробілів з підкресленнями (налаштовується за допомогою $wgRestrictDisplayTitle). Може бути заборонено параметром $wgAllowDisplayTitle; за замовчуванням дозволено починаючи з MW 1.10.
Може приймати другий аргумент noerror (сховати повідомлення про помилку при повторному використанні цієї змінної на сторінці) або noreplace (проігнорувати цю змінну, якщо вона використана вище на цій сторінці).
|
(для noerror та noreplace)
|
{{DEFAULTSORT:ключ}}
{{DEFAULTSORTKEY:ключ}}
{{DEFAULTCATEGORYSORT:ключ}}
{{DEFAULTSORT:ключ|noerror}}
{{DEFAULTSORT:ключ|noreplace}}
|
|
Визначає ключ сортування для категоризованої сторінки. Приміром, якщо написати {{DEFAULTSORT:Smith , John}} на сторінці з назвою John Smith, то сторінка потрапить під літеру "S" на сторінках категорій. Може приймати другий аргумент noerror (сховати повідомлення про помилку при повторному використанні цієї змінної на сторінці) або noreplace (проігнорувати цю змінну, якщо вона використана вище на цій сторінці).
|
(для noerror та noreplace)
|
Статистика
Числа, повернуті цими змінними, зазвичай містять символи розділення десяткових розрядів (кома, крапка, пробіл залежно від мови локалізації), але використання прапорця ":R" дасть неформатоване число (приміром, {{NUMBEROFPAGES}} → 658 099, але {{NUMBEROFPAGES:R}} → 658099).
Використовуйте "|R" для магічних слів, яким потрібен параметр, подібних до PAGESINCATEGORY (приміром, {{PAGESINCATEGORY:Help}} та {{PAGESINCATEGORY:Help|R}}, або {{PAGESINCATEGORY:Help|subcats}} та {{PAGESINCATEGORY:Help|subcats|R}}). Те ж саме стосується {{PAGESIZE:назва сторінки}}, див. нижче.
Числові значення змінних форматуються залежно від мовних налаштувань вікі-проекту. Починаючи з версії MW 1.19, вони залежать від мови сторінки.
| Змінна
|
Її отримане значення
|
Опис
|
Версії
|
{{NUMBEROFPAGES}}
|
658 099
|
Кількість сторінок вікі-проекту.
|
|
{{NUMBEROFARTICLES}}
|
35 617
|
Кількість сторінок в основному просторі імен.
|
|
{{NUMBEROFFILES}}
|
3825
|
Кількість завантажених файлів.
|
|
{{NUMBEROFEDITS}}
|
2 699 937
|
Загальна кількість змін сторінок.
|
|
{{NUMBEROFVIEWS}}
|
|
Кількість переглядів сторінки. Не має сенсу для вікі-проектів, які використовують кешування. Removed in Gerrit change 150699.
|
|
{{NUMBEROFUSERS}}
|
13 869 256
|
Кількість облікових записів користувачів.
|
|
{{NUMBEROFADMINS}}
|
190
|
Кількість учасників групи sysop.
|
|
{{NUMBEROFACTIVEUSERS}}
|
1544
|
Кількість активних учасників, визначених за критерієм як у Special:Statistics.
|
|
{{PAGESINCATEGORY:categoryname}}
{{PAGESINCAT:categoryname}}
|
118
118
|
[Expensive] [Витратна] Кількість сторінок (з підкатегоріями та файлами включно) в заданій категорії categoryname.
|
|
{{PAGESINCATEGORY:categoryname|all}}
{{PAGESINCATEGORY:categoryname|pages}}
{{PAGESINCATEGORY:categoryname|subcats}}
{{PAGESINCATEGORY:categoryname|files}}
|
118
105
10
3
|
[Expensive]
[Витратна] Кількість відповідно
- всіх сторінок
- звичайних сторінок (виключаючи підкатегорії та файли)
- підкатегорій
- файлів
в заданій категорії categoryname.
|
|
{{NUMBERINGROUP:groupname}}
{{NUMINGROUP:groupname}}
|
33
33
({{NUMBERINGROUP:bureaucrat}} used here)
|
Кількість користувачів в заданій групі groupname.
|
|
{{PAGESINNS:index}}
{{PAGESINNAMESPACE:index}}
|
Вимкнено
|
[Expensive] [Витратна] Кількість сторінок в заданому просторі назв (замініть index відповідним номером простору назв). Приміром, {{PAGESINNAMESPACE:14}} дасть кількість сторінок категорій. {{PAGESINNS:0}} відрізняється від {{NUMBEROFARTICLES}} тим, що перша включає сторінки перенаправлень і розв'язання синтаксичних неоднозначностей. Вимкнено за замовчуванням, можна включити у $wgAllowSlowParserFunctions.
|
|
Назви сторінок
| Змінна
|
Її отримане значення
|
Опис
|
Версії
|
{{FULLPAGENAME}}
|
Help:Magic words/uk
|
Простір назв та повна назва сторінки (включно із усіма рівнями підсторінки).
|
|
{{PAGENAME}}
|
Magic words/uk
|
Повна назва сторінки (включно із усіма рівнями підсторінки) без простору назв.
|
|
{{BASEPAGENAME}}
|
Magic words
|
Назва сторінки без назви поточної підсторінки та без простору назв (дає "Сторінка/підсторінка" для "Довідка:Сторінка/підсторінка/код мови").
Для складнішого розщеплення назви зверніться до функції {{#titleparts:}} з розширення ParserFunctions.
|
|
{{SUBPAGENAME}}
|
uk
|
Назва поточної підсторінки (дає "код мови" для "Довідка:Сторінка/підсторінка/код мови").
|
|
{{SUBJECTPAGENAME}}
{{ARTICLEPAGENAME}}
|
Help:Magic words/uk
Help:Magic words/uk
|
На сторінці обговорення: повна назва основної сторінки, пов'язаної з цією сторінкою обговорення.
|
|
{{TALKPAGENAME}}
|
Help talk:Magic words/uk
|
Повна назва сторінки обговорення для поточної сторінки.
|
|
{{ROOTPAGENAME}}
|
Magic words
|
Name of the root of the current page. Would return Title on page Help:Title/Foo/Bar
|
|
Магічні слова {{BASEPAGENAME}} та {{SUBPAGENAME}} працюють лише в просторах імен, в яких дозволено підсторінки. Про дозвіл підсторінок див. $wgNamespacesWithSubpages.
Починаючи з версії MW 1.15+, всі ці змінні можуть приймати параметр, яким можна задати назву сторінки, яка (замість поточної) визначить значення змінної:
{{PAGENAME:Template:Main Page}} → Main Page
 Увага: | If the page title contains any parts that are "." or "..", the magic word fails returning nothing.
{{PAGENAME:one/./three}} → '. Nothing is returned.
|
| Увага: | | Увага: | Назви сторінок, що містять певні символи, такі як апостроф ' чи зірочка *, можуть при роботі з цими змінними продукувати неочікувані результати, такі як {{PAGESINCATEGORY:{{PAGENAME}}}}. Див. повідомлення про помилки 14779, 16474, 35628 та 35746. Простим способом запобігти цьому є екранування назви сторінки функцією парсера #titleparts. |
Приміром, для сторінки з назвою "L'Aquila" наступний код відобразить повідомлення "Numeric char encoding":
{{#switch:{{PAGENAME}}
| L'Aquila = No translation
| L = Not OK
| L'Aquila = Entity escaping
| L'Aquila = Numeric char encoding
}} |
Кодування назви сторінки в URL
Нижче наведено перелік еквівалентних змінних, які дають результат, придатний для кодування URL, - певні символи, такі як апостроф, знак запитання тощо, замінено їхніми числовими кодами для URL, а пробіли - підкресленням:
{{FULLPAGENAMEE}}{{PAGENAMEE}}{{BASEPAGENAMEE}}{{SUBPAGENAMEE}}{{SUBJECTPAGENAMEE}}{{ARTICLEPAGENAMEE}}{{TALKPAGENAMEE}}{{ROOTPAGENAMEE}}
Зверніть увагу на те, що {{PAGENAME:...}}, {{PAGENAMEE:...}} та {{urlencode:...}} реалізовано різним чином. Детальніше див. Manual:PAGENAMEE encoding.
Простори імен
| Змінна
|
Її отримане значення
|
Опис
|
Версії
|
{{NAMESPACE}}
|
Help
|
Назва простору імен, в якому знаходиться сторінка
|
|
{{NAMESPACENUMBER}}
|
12
|
Номер (внутрішній MediaWiki ID) простору імен сторінки
|
|
{{SUBJECTSPACE}}
{{ARTICLESPACE}}
|
Help
Help
|
На сторінці обговорення: назва простору імен пов'язаної основної сторінки
|
|
{{TALKSPACE}}
|
Help talk
|
Назва простору імен для сторінки обговорення поточної сторінки
|
|
Нижче наведено перелік еквівалентних змінних, які дають результат, придатний для кодування URL, - певні символи, такі як підкреслення, апостроф, знак запитання тощо, замінено їхніми числовими кодами для URL:
{{NAMESPACEE}}{{SUBJECTSPACEE}}{{ARTICLESPACEE}}{{TALKSPACEE}}
Починаючи з версії 1.15+, ці функції можуть приймати як параметр повну назву сторінки замість поточної:
{{NAMESPACE:MediaWiki}} → (Pages in main space will return empty){{NAMESPACE:Template:Main Page}} → Template{{SUBJECTSPACE:Template:Main Page}} → Template{{TALKSPACE:Template:Main Page}} → Template talk
Цей параметр не повинен бути назвою простору імен:
{{SUBJECTSPACE:Help talk}} → (Empty)
Інше
| Змінна
|
Її отримане значення
|
Опис
|
Версії
|
{{!}}
|
|
|
Використовується для того, щоб включити символ вертикальної риски як частину аргументу шаблону. Поки це магічне слово не було реалізоване, багато вікі-проектів розв'язували таку задачу створенням шаблону Template:!, який містив єдиний символ |.
|
|
Функції парсера
Функції парсера (синтаксичного аналізатора) дуже подібні до змінних, але приймають один чи більше параметрів. З технічної точки зору, будь-яке магічне слово, що приймає аргумент, є функцією парсера. Їхнім назвам інколи передує символ решітки "#", щоб відрізнити їх від звернення до шаблонів.
Ця стаття описує лише функції парсера, які вбудовані у код MediaWiki. Будь-які інші функції парсера можуть бути додані розширеннями MediaWiki, такими як Extension:ParserFunctionsExtension:ParserFunctions; документація на відповідних сторінках довідки (Help:Extension:ParserFunctionsHelp:Extension:ParserFunctions).
Технічні метадані іншої сторінки
| Функція парсера
|
Її отримане значення
(для сторінки MediaWiki)
|
Опис
|
Версії
|
{{PAGEID: назва сторінки }}
|
1
|
[Expensive] [Витратна] Дає ідентифікатор вказаної сторінки*.
|
|
{{PAGESIZE: page name }}
{{PAGESIZE: page name |R}}
|
180
180
|
[Expensive] [Витратна] Дає розмір в байтах вказаної сторінки. Використовуйте "|R" для отримання неформатованого числа (без групування розрядів).
|
|
{{PROTECTIONLEVEL:дія | page name}}
|
sysop
|
[Expensive] [Витратна] Повертає необхідний рівень доступу (e.g. "autoconfirmed", "sysop") для заданої дії (Edit, Move тощо) на вказаній сторінці, або порожній рядок для незахищеної сторінки.
|
|
{{PROTECTIONEXPIRY:
action |
page name}}
|
infinity
|
[Expensive] Outputs the protection expiry (e.g. "20160418155030", "infinity") for a given action (e.g. "edit", "move") on the specified page. Returns "infinity" if not protected.
|
|
{{CASCADINGSOURCES: page name}}
|
|
[Expensive] [Витратна] Повертає перелік джерел каскадного захисту, активних на вказаній сторінці. Цей перелік не вміщуватиме назву вказаної сторінки, якщо та не містить команд включення власних частин.
|
|
{{REVISIONID: page name }}
|
2301969
|
[Expensive] [Витратна] Дає унікальний ідентифікатор останньої зміни вказаної сторінки*.
|
|
{{REVISIONDAY: page name }}
|
4
|
[Expensive] [Витратна] Дає день останньої зміни вказаної сторінки* (число, без вирівнювання).
|
|
{{REVISIONDAY2: page name }}
|
04
|
[Expensive] [Витратна] Дає день останньої зміни вказаної сторінки* (число, при необхідності доповнене нулем).
|
|
{{REVISIONMONTH: page name }}
|
12
|
[Expensive] [Витратна] Дає місяць останньої зміни вказаної сторінки* (число, при необхідності доповнене нулем, починаючи з версії 1.17+; число без вирівнювання для старіших версій).
|
|
{{REVISIONMONTH1: page name }}
|
12
|
[Expensive] [Витратна] Дає місяць останньої зміни вказаної сторінки* (число, без вирівнювання).
|
|
{{REVISIONYEAR: page name }}
|
2016
|
[Expensive] [Витратна] Дає рік останньої зміни вказаної сторінки*.
|
|
{{REVISIONTIMESTAMP: page name }}
|
20161204201240
|
[Expensive] [Витратна] Дає часову мітку останньої зміни вказаної сторінки*.
|
|
{{REVISIONUSER: page name }}
|
MusikAnimal
|
[Expensive] [Витратна] Дає ім'я користувача, якому належить остання зміна вказаної сторінки*.
|
|
| *Якщо вказаний параметр збігається з назвою поточної сторінки, функції парсера даватимуть інформацію про попередню версію сторінки в разі попереднього перегляду та підстановки (порожні строки при створенні сторінки). При звичайному перегляді (включно з переглядом минулих версій) функції даватимуть інформацію про поточну сторінку і можуть не вважатися витратними.
|
Дані URL
| Функція парсера
|
Приклад → Результат
|
Опис
|
Версії
|
|
|
{{localurl:page name}}
{{localurl:page name|query_string}}
|
{{localurl:MediaWiki}}
→ /wiki/MediaWiki
{{localurl:MediaWiki|printable=yes}}
→ /w/index.php?title=MediaWiki&printable=yes
|
Відносний шлях до назви сторінки, з опціональним параметром query_string.
|
|
|
|
{{fullurl:page name}}
{{fullurl:page name
|query_string}}
{{fullurl:interwiki:remote page name
|query_string}}
|
{{fullurl:Category:Top level}}
→ //www.mediawiki.org/wiki/Category:Top_level
{{fullurl:Category:Top level|action=edit}}
→ //www.mediawiki.org/w/index.php?title=Category:Top_level&action=edit
{{fullurl:s:Electra|action=edit}}
→ https://en.wikisource.org/wiki/Electra?action=edit
{{fullurl:s:es:Electra|action=edit}}
→ https://en.wikisource.org/wiki/es:Electra?action=edit
|
Веб-посилання на сторінку без уточнення протоколу. Дозволено префікси інтервікі. Примітка: якщо таке посилання не взяте в квадратні дужки, воно не буде автоматично зроблено активним.
|
|
|
|
{{canonicalurl:page name}}
{{canonicalurl:page name
|query_string}}
{{canonicalurl:interwiki:remote page name
|query_string}}
|
{{canonicalurl:Category:Top level}}
→ https://www.mediawiki.org/wiki/Category:Top_level
{{canonicalurl:Category:Top level|action=edit}}
→ https://www.mediawiki.org/w/index.php?title=Category:Top_level&action=edit
|
Абсолютний шлях до назви сторінки, канонізований URL. Також дозволено префікси інтервікі.
|
|
|
|
{{filepath:file name}}
{{filepath:file name|nowiki}}
{{filepath:file name|thumbnail_size}}
|
{{filepath:Wiki.png}}
→ //upload.wikimedia.org/wikipedia/mediawiki/b/bc/Wiki.png
{{filepath:Wiki.png|nowiki}}
→ //upload.wikimedia.org/wikipedia/mediawiki/b/bc/Wiki.png
{{filepath:Example.svg|300}}
→ //upload.wikimedia.org/wikipedia/commons/thumb/8/84/Example.svg/300px-Example.svg.png
|
Шлях до ескізу (1.18+) медіа-файлу без уточнення протоколу.
|
|
|
|
{{urlencode:string}} (or {{urlencode:string|QUERY}})
{{urlencode:string|WIKI}}
{{urlencode:string|PATH}}
|
{{urlencode:x:y/z á é}} or
{{urlencode:x:y/z á é|QUERY}}
→ x%3Ay%2Fz+%C3%A1+%C3%A9
{{urlencode:x:y/z á é|WIKI}}
→ x:y/z_%C3%A1_%C3%A9
{{urlencode:x:y/z á é|PATH}}
→ x%3Ay%2Fz%20%C3%A1%20%C3%A9
Зверніть увагу, що за замовчуванням мається на увазі параметр |QUERY замість |WIKI, який мався раніше від MW 1.17. Це може вплинути на старі шаблони, які використовують цю функцію.
|
Параметр string кодується для використання в URL. Аналогічної функції декодування не існує (є лише в застарілому розширенні Extension:StringFunctionsExtension:StringFunctions)..
Encoding| code | space |
|---|
| none | + | | QUERY | + | | WIKI | _ | | PATH | %20 |
|
(or
)
|
|
|
{{anchorencode:string}}
|
{{anchorencode:x y z á é}}
→ x_y_z_á_é
|
Параметр string кодується для використання в URL в секції якоря (після символу решітки "#" в URL)
|
|
Простори імен
Функція {{ns:}} дає назву простору імен поточною мовою для вказаного номеру, канонічного імені чи локального синоніму простору імен. Отже, {{ns:6}}, {{ns:File}}, та {{ns:Image}} (застаріла назва) повертають "File". На сторінках вікі-проекту із французською мовою вмісту запис {{ns:Fichier}} (французська назва файлу) також буде правильним, але {{ns:Datei}} (німецька назва) не буде.
{{nse:}} - еквівалентна функція, але її результат кодований для використання в URL MediaWiki. Вона замінює пробіли підкресленнями.
| Простори імен для статей
|
|
Простори імен для сторінок обговорення
|
| Використання
|
Результат
|
Використання
|
Результат
|
{{ns:-2}} / {{ns:Media}}
|
Media
|
{{ns:-1}} / {{ns:Special}}
|
Special
(no talk page)
|
{{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
Varies between wikis
|
{{ns:5}} / {{ns:Project talk}}
|
Project talk
|
{{ns:6}} / {{ns:File}} or {{ns:Image}}
|
File
|
{{ns:7}} / {{ns:File talk}} or {{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
|
Не слід плутати перекладені вашою мовою назви стандартних просторів імен із налаштовуваними просторами імен.
Форматування
| Використання
|
Приклад → Результат
|
Опис
|
Версії
|
{{formatnum:unformatted number}}
{{formatnum:formatnum-formatted number|R}}
{{formatnum:unformatted number|NOSEP}}
|
- Просте:
{{formatnum:987654321.654321}}
→ 987 654 321,654321{{formatnum:987 654 321,654321|R}}
→ 987654321.654321
- Складніше:
{{formatnum:{{formatnum:987654321.654321}}|R}}
→ 987654321.654321 (для будь-якої мови){{formatnum:00001}}
→ 00 001{{formatnum:987654321.654321 |NOSEP}}
→ 987654321.654321- Приклади для мови гінді:
{{formatnum:987654321.654321}}
→ ৯৮,৭৬,৫৪,৩২১.৬৫৪৩২১{{formatnum:987654321.654321 |NOSEP}}
→ ৯৮৭৬৫৪৩২১.৬৫৪৩২১{{formatnum:৯৮,৭৬,৫৪,৩২১.৬৫৪৩২১ |R}}
→ 987654321.654321
Не підтримується:
{{formatnum:{{formatnum:987.654.321}}}}
→ 987 654 321 (приміром, для італійської)
Приклади помилкового вводу (результат незрозумілий), з або без |R:
{{formatnum:987,654.321|R}} (найменше некоректний)
{{formatnum:987.654,321|R}}
{{formatnum:987 654,321|R}}
{{formatnum:987 654,321|R}}
|
Приймає неформатоване число (арабськими, без розділювача груп розрядів та з . як десятковим розділювачем) і розмічає його відповідно до мови по замовчуванню вікі-проекту.
Параметр |R визначає зворотний напрямок кодування, для виконання математичних дій з числом. Таке декодування дозволене й має сенс лише в тих випадках, коли вихідне число форматоване саме так, як би його сформатувала функція formatnum.
Додатковий параметр NOSEP ("no separators") забороняє змінювати розділювачі, і formatnum лише перетворить цифри для мов, які не використовують Індо-арабську систему числення. Він також запобігає нестандартному групуванню розрядів, якого ви не чекаєте.
| Увага: | У випадку неправильного формату аргументу не очікуйте від функції змістовного результату, особливо для неангломовних проектів. |
Якщо ж конче необхідно розмітити число з невідомого вихідного формату у відповідності з діючим мовним налаштуванням, спробуйте застосувати formatnum двічі, за певних умов це може вдатися.
|
|
|
{{#dateformat:date}}
{{#formatdate:date}}
{{#dateformat:date|format}}
{{#formatdate:date|format}}
|
{{#dateformat:25 dec 2009|ymd}}
→ 25 dec 2009 (ваше), 2009 DeC 25 (замовч.)
{{#formatdate:dec 25,2009|dmy}}
→ dec 25,2009 (ваше), 25 Dec 2009 (замовч.)
{{#dateformat:2009-12-25|mdy}}
→ грудень 25, 2009 (ваше), December 25, 2009 (замовч.)
{{#formatdate:2009 dec 25|ISO 8601}}
→ 2009 dec 25 (ваше), 2009-12-25 (замовч.)
{{#dateformat:25 decEmber|mdy}}
→ 25 decEmber (ваше), DecEmber 25 (замовч.)
Примітка: У цих прикладах, "ваше" позначає результат форматування з використанням ваших поточних налаштувань тут, "замовч." - результат при налаштуванні по замовчуванню.
|
Форматує абстрактну дату на основі ваших налаштувань "формат дати" і додає до результату метадані, що позначають його як форматовану дату. Для неавторизованих користувачів або тих, хто не обрав формат дати в особистих налаштуваннях, дати будуть видані у форматі замовчування: mdy, dmy, ymd, ISO 8601 (всі параметри чуттєві до регістру літер). Якщо задано тільки місяць та день, дозволено лише mdy та dmy. Якщо формат не вказано або він неправильний, використовується формат вводу дати. Якщо вказана дата не розпізнається як коректна (а саме, якщо вона містить метадані з попередньої розмітки цією чи подібною функцією), вона не змінюється та (додаткові) метадані не генеруються.
| Увага: | Григоріанським календарем], ця функція з параметром ISO розмічатиме також дати, що виходять за його звичайні межі (до 1583 року). Також ця функція нездатна правильно перетворювати негативні роки (з ISO 8601) та роки до Різдва Христова (BC чи BCE). |
|
|
{{lc:string}}
|
{{lc:DATA CENTER}} → data center
|
Перетворення всіх символів на символи нижнього регістру.
|
|
{{lcfirst:string}}
|
{{lcfirst:DATA center}} → dATA center
|
Перетворення найпершого символу параметра до нижнього регістру.
|
|
{{uc:string}}
|
{{uc:text transform}} → TEXT TRANSFORM
|
Перетворення всіх символів на символи верхнього регістру.
|
|
{{ucfirst:string}}
|
{{ucfirst:text TRANSFORM}} → Text TRANSFORM
|
Перетворення найпершого символу параметра до верхнього регістру.
|
|
{{padleft:xyz|stringlength}}
{{padleft:xyz|strlen|char}}
{{padleft:xyz|strlen|string}}
|
{{padleft:xyz|5}} → 00xyz
{{padleft:xyz|5|_}} → __xyz
{{padleft:xyz|5|abc}} → abxyz
{{padleft:xyz|2}} → xyz
{{padleft:|1|xyz}} → x
(перший символ параметра)
|
Вирівнює перший параметр додаванням зліва символів вирівнювання (третій параметр, по замовчуванню "0") до заданої ширини (другий параметр). Якщо строка символів вирівнювання (після необхідної кількості повторювань) довша, ніж потрібно, зайві її символи буде відкинуто.
До версії MW 1.12 використовувався лише перший символ строки для вирівнювання (третього параметру), із 1.15 беруться всі символи.
Помилка (виправлена у r45734): символ, що кодується двома байтами, рахувався за два символи, що знецінювало параметр ширини. Такі символи не можна використовувати як символи вирівнювання.
|
|
{{padright:xyz|stringlength}}
{{padright:xyz|strlen|char}}
{{padright:xyz|strlen|string}}
|
{{padright:xyz|5}} → xyz00
{{padright:xyz|5|_}} → xyz__
{{padright:xyz|5|abc}} → xyzab
{{padright:xyz|2}} → xyz
{{padright:|1|xyz}} → x
|
Так само як padleft, але додає символи вирівнювання праворуч (наприкінці) першого параметра.
|
|
Див. також: Extension:StringFunctionsExtension:StringFunctions.
Локалізація
Ці магічні слова застосовуються як основні інструменти локалізації. Деякі магічні слова залежатимуть від мовного та інших налаштувань вікі-проекту або від обраної користувачем мови: див. #Date and time, #Formatting, #Miscellaneous тощо. Додаткові магічні слова визначені у Розширення:TranslateExtension:Translate.
Використання цих магічних слів може бути дуже складним, а цей опис наразі неповний. Детальніша інформація на PLURAL, GRAMMAR, GENDER.
| Використання
|
Приклад → Результат
|
Опис
|
Версії
|
{{plural:2|is|are}}
|
{{plural:0|is|are}} → are
{{plural:1*1|is|are}} → is
{{plural:21 mod 10|is|are}} → is
{{plural:{{#expr:21 mod 10}}|is|are}} → is
{{plural:1|is|are}} → is
{{plural:2|is|are}} → are
{{plural:-1|is|are}} → is
{{plural:-2|is|are}} → are
{{plural:0.5|is|are}} → are
{{plural:1.5|is|are}} → are
{{plural:-0.5|is|are}} → are
{{plural:-1.5|is|are}} → are
(Для української)
{{PLURAL:5|1=Категория|Категории}} → Категории
{{PLURAL:3|страница|страницы|страниц}} → страницы
{{PLURAL:5|страница|страницы|страниц}} → страниц
|
Дає форму однини (другий параметр), якщо перший параметр дорівнює 1, і форму множини (третій параметр) в іншому разі. Функціонування залежить від обраної мови.
Певні мови (ab, av, ba, bxr, ce, crh_cyrl, cv, inh, koi, krc, kv, lbe, lez, mhr, mrj, myv, ru, tt_cyrl, tyv, udm, uk, xal), включно з українською, використовують 3 різні форми (updated 01.2014):
- Форма 1: для 1, 21, 31, 41, 51, 61, 71, 81, 101, 1001, …
- Форма 2: для 0, 5, 6, 7,8,...18, 19, 100, 1000, 10000, 100000, 1000000, …
- Форма 3: для 2, 3, 4, 22, 23, 24, 32, 33, 34, 42, 43, 44, 52, 53, 54, 62, 102, 1002, …
|
|
{{grammar:N|noun}}
|
|
Дає слово в правильній граматичній формі згідно з мовно-залежним кодом граматичної форми, вказаним після двокрапки. Граматична трансформація використовується у флексивних мовах: польська, російська, українська тощо. Див. також $wgGrammarForms.
|
|
{{gender:username|text for every gender}}
{{gender:Username|male text|female text|text for unspecified}}
{{gender:|male text|female text|text for unspecified}}
{{gender:.|male text|female text|text for unspecified}}
|
(Залежить від вказаного в особистих налаштуваннях гендеру користувача)
|
Перемикач, залежний від вказаного користувачем у Special:Preferences гендеру.
Примітка: в першому прикладі функція завжди поверне параметр як він є
Примітка: якщо третього параметра немає і гендер в налаштуваннях користувача не вказано, буде використано текст для чоловіка.
Відсутнє поле Username ({{gender:|) визначає поточного користувача.
Крапка (.) замість імені користувача визначає гендер користувача по замовчуванню, налаштований у вікі-проекті.
|
|
{{int:назва повідомлення}}
|
{{int:edit}} → Edit
(Залежить від обраної користувачем мови; спробуйте: fr • ja)
|
Інтернаціоналізує (перекладає) задане параметром інтерфейсне (interface) повідомлення із простору імен MediaWiki мовою користувача. Про msgnw та інші магічні слова, пов'язані зі включенням, див. Help:Magic words#Template modifiers. "Відмітьте, що це може пошкодити/переплутати посилання в кеші у MediaWiki 1.17 чи старішій, див. помилку 14404.
|
|
{{int:editsectionhint|MediaWiki}}
|
{{int:editsectionhint|MediaWiki}} → Edit section: MediaWiki
|
Ви також можете використовувати параметри для перекладу.
Параметри позначаються у повідомленнях так: $1, $2, $3 тощо. Приміром, ось повідомлення для 'editsectionhint: Edit section: $1
В цьому прикладі MediaWiki замінить $1.
|
|
Transclusion modifiers
{{Page name|optional params}} usually transcludes another page, by default from the Template:namespace.
These magic words modify that behavior.
| Usage
|
Output
|
Description
|
Version
|
{{:xyz}}
|
|
A bare colon is not a template modifier but the prefix for the main namespace. Since transclusion defaults to the Template namespace, you would use for example, {{:UTC}} (vs. {{UTC}}) to include the text of the main namespace article UTC rather than Template:UTC.
|
|
{{int:xyz}}
|
|
Same as {{MediaWiki:xyz}}, except standard message translation is applied depending on subpages and content/user/uselang language. Another difference is: this doesn't appear under "Шаблони, використані на цій сторінці:". Rendered as ⧼xyz⧽ if MediaWiki:xyz doesn't exist. See also Help:System messageHelp:System message.
|
|
{{msg:xyz}}
{{raw:xyz}}
|
|
Even if there is a magic word named "xyz", use template:xyz unless the template doesn't exist (equivalent to {{template:xyz}}). Normally, magic words have priority when there is a conflict.
|
(raw)
|
{{msgnw:xyz}}
|
|
The unexpanded wikitext is rendered (more or less, for details see msgnwHelp:Template#msgnw).
|
|
{{subst:xyz}}
|
|
In the wikitext, the tag is substituted by the content (single-level evaluation only), see Template usage.
|
|
Інше
| Використання
|
Результат
|
Опис
|
Версії
|
{{#language:language code}}
{{#language:ar}}
{{#language:language code|
target language code}}
{{#language:ar|en}}
|
language code
العربية
language code
Arabic
|
Повна назва мови для заданого коду мови: за замовчуванням власна природна назва, перекладена цільовою мовою, якщо код цільової мова вказано після вертикальної риски. До цієї функції дає доступ розширення Extension:CLDRExtension:CLDR.
|
(переклад)
|
{{#special:special page name}}
{{#special:userlogin}}
|
Special:Special page name
Special:UserLogin
|
Локалізована назва для заданої службової сторінки із простору імен Special:.
|
|
{{#speciale:special page name}}
{{#speciale:userlogin}}
|
Special:Special_page_name
Special:UserLogin
|
Локалізована назва для заданої службової сторінки із простору імен Special:, закодована для використання в URL.
|
|
{{#tag:tagname
|content
|attribute1=value1
|attribute2=value2
}}
|
(Залежить від tagname)
|
Синонім для подібних до XML теґів розширень чи парсера MediaWiki . Дозволяє виконання коду вікі та Extension:ParserFunctionsExtension:ParserFunctions всередині теґу перж ніж цей теґ буде оброблено. Також запобігає парсингу теґів на умовних шляхах виконання (приміром, під #if), які не будуть ефективними за даних умов. Вміст передається між теґами як перший параметр, атрибути можуть передаватися як наступні параметри. Отже, таку конструкцію:
<tagname attribute1="value1" attribute2="value2">Вміст теґу тут.</tagname>
можна переписати у вигляді:
{{#tag:tagname|Вміст теґу тут.|attribute1=value1|attribute2=value2}}
Приклад для теґу <ref> розширення для цитувань:
{{#tag:ref|Тут записано текст посилання, в якому дозволено використання функцій парсера, як-от {{#expr: ... }}, та магічних слів, як-от {{PAGENAME}}.|name="multiple"}}
| Увага: | Для того, щоб передати порожній вміст, слід записувати {{#tag:tagname||attribute1=value1|attribute2=value2}}. В області між вертикальними рисками ||, зарезервованій для вмісту, пробіл не дозволено. |
|
|
Увага: 
