 |
Зверніть увагу! Коли Ви редагуєте цю сторінку, то погоджуєтесь робити свій внесок під ліцензією CC0. Детальніше про умови ліцензії можна дізнатися на сторінці довідки.
|
|
Магічними словами (magic words) називають певні комбінації символів, яким MediaWiki зіставляє певне значення чи функцію — поточний час, назву поточної сторінки, поточного сайту тощо. Ця стаття пояснює лише стандартні магічні слова; Дізнатися детальніше — див. Manual:Magic words .
Розрізнюють три загальні типи магічних слів:
- Перемикачі поведінки (behavior switches): зазвичай складені з літер верхнього регістру та двох символів підкреслення по боках, як-от
__FOO__..
- Змінні: слова в подвійних фігурних дужках, складені з літер верхнього регістру, як-от
{{FOO}}. Виглядають як виклик шаблона.
Змінні та функції парсера здатні використовувати підстановку subst:, подібно до шаблонів. Магічні слова, призначені для роботи зі сторінкою, змінюють чи повертають дані про поточну сторінку (якщо в параметрах явно не вказано інше), навіть коли вони включені з шаблону чи системного повідомлення.
Перемикачі поведінки
Перемикачі поведінки управляють виглядом чи поведінкою сторінки вікі (якщо це підтримується темою) і часто використовуються для включення певних блоків інформації до її тексту. Деякі з цих перемикачів поведінки не підтримуються темою "Minerva".
| Слово
|
Опис
|
Версії
|
| Зміст
|
__NOTOC__
|
Приховує зміст.
|
|
__FORCETOC__
|
Примусово показує зміст на його звичайній позиції (перед першим заголовком, відміняє дію перемикача __NOTOC__).
|
|
__TOC__
|
Показує зміст в місці розташування цього слова (має пріоритет над __NOTOC__). Ефект має тільки однократне використання, повтори на тій самій сторінці ігноруються.
|
|
| Редагування
|
__NOEDITSECTION__
|
Приховує посилання для редагування розділу, що зазвичай стоїть біля його заголовка. Особливо корисне, коли заголовок включено із шаблону. В такому випадку звичайне редагування розділу змінюватиме код шаблону, це - зазвичай не очікувана користувачем поведінка. Якщо шаблон містить кілька заголовків, може бути необхідним додати "$noeditsection" після кожного заголовка. Використання цього виразу всередині шаблону, поширить дію виразу і на сам шаблон, сторінки до яких він включений і на всі інші шаблони включені до цієї сторінки. Інший спосіб див. тут.
|
|
__NEWSECTIONLINK__
|
Поруч із вкладкою "Редагувати" додає вкладку для створення нового розділу на звичайних сторінках (подібно до сторінок обговорення), див. Додавання розділу наприкінці статті.
|
|
__NONEWSECTIONLINK__
|
Видаляє посилання поруч зі вкладкою «Редагувати» на сторінках просторів назв обговорень.
|
|
| Категорії
|
__NOGALLERY__
|
На сторінці категорії замінює ескізи зображень звичайними текстовими посиланнями.
|
|
__HIDDENCAT__
|
На сторінці категорії: приховує цю категорію від внесення у покажчик категорій батьківських категорій та категоризованих сторінок (користувач може це заборонити за допомогою власних налаштувань).
|
|
__EXPECTUNUSEDCATEGORY__
|
Використовується на сторінках категорій, вилучає категорію з Special:UnusedCategories.
|
|
| Мовні перетворення
|
__NOCONTENTCONVERT__
__NOCC__
|
Забороняє будь-які мовні перетворення вмісту для мовних варіантів на сторінці, для тих вікі-проектів, які мають мовні варіанти сторінок. Так, приміром, буде використана основна мова китайська (zh) замість її варіантів zh_cn, zh_tw, zh_sg, zh_hk тощо.
|
|
__NOTITLECONVERT__
__NOTC__
|
Забороняє мовні перетворення лише назв сторінок для тих вікі проектів, які мають мовні варіанти сторінок.
|
|
| Інше
|
__START__
|
Наразі, не діє. Використовувався для вказання початку повідомлення бази даних після коментарю, який не повинен був бути включеним. Видалено в r1695 та повністю видалено в r24784
|
|
__END__
|
Явно визначає кінець статті, не дозволяючи рушію MediaWiki відкинути кінцеві порожні рядки. Видалено в 19213.
|
|
__INDEX__
|
Каже пошуковим рушіям індексувати сторінку (перекриває $wgArticleRobotPolicies, але не robots.txt). Підкорюється змінній $wgExemptFromUserRobotsControl.
|
|
__NOINDEX__
|
Забороняє пошуковим системам індексувати сторінку (сторінка не може виринути в результатах пошуку цих систем). Підкоряється налаштуванню $wgExemptFromUserRobotsControl.
|
|
__STATICREDIRECT__
|
На сторінках перенаправлення: не дозволяє MediaWiki автоматично оновити посилання у випадку, коли дописувач переносить сторінку і вмикає прапорець "Виправити всі перенаправлення на попередню назву" (що потребує $wgFixDoubleRedirects).
|
|
| Розширення
|
| Розширення
|
Слово
|
Опис
|
Версії
|
| GlobalUserPage
|
__NOGLOBAL__
|
Відключає використання глобальної сторінки користувача. Якщо присутнє на центральній сторінці користувача, то відключить відображення цієї сторінки на інших вікі, де не створена сторінка користувача. Також визначає чи мають бути посилання на сторінки користувача на інших вікі синіми або червоними.
|
|
| Disambiguator
|
__DISAMBIG__
|
Позначає сторінку як сторінку розв'язування неоднозначностей.
|
|
Змінні
Змінні надають інформацію про поточну сторінку, вікі, дату тощо. Їх використання синтаксично подібне до шаблонів. Використання змінних із позначкою "[Витратна]" контролюється рушієм MediaWiki, і кількість таких використань на одній сторінці може бути обмеженою.
Якщо назва шаблону збігається із назвою змінної, пріоритет має змінна. Для розгортання, приміром, такого шаблону Template:PAGENAME вам доведеться написати {{Template:PAGENAME}}. Але в деяких випадках вказаний параметр примусить парсер підключити шаблон; приміром, {{CURRENTDAYNAME|x}} звертається до Template:CURRENTDAYNAME, не до однойменної змінної.
Дата і час
Наступні змінні дають поточну дату і час за Гринвічем (UTC).
Внаслідок кешування MediaWiki і веб-оглядача, ці змінні дають час останнього кешування сторінки замість поточного.
The use of those variables cause pages to be cached for a more limited number of seconds. This is configured in MagicWordFactory.
Формат отриманих дати й часу залежить від мови вмісту вікі-проекту. Починаючи з MW 1.19, цей формат визначається мовою сторінки.
| Змінна
|
Її отримане значення
|
Опис
|
Версії
|
| Рік
|
{{CURRENTYEAR}}
|
2019
|
Рік
|
|
| Місяць
|
{{CURRENTMONTH}}
|
11
|
Місяць (число, при необхідності доповнене нулем)
|
|
{{CURRENTMONTH1}}
|
11
|
Місяць (без доповнення нулем)
|
|
{{CURRENTMONTHNAME}}
|
листопад
|
Місяць (назва)
|
|
{{CURRENTMONTHNAMEGEN}}
|
листопада
|
Місяць (в родовому відмінку)
|
|
{{CURRENTMONTHABBREV}}
|
лис
|
Місяць (скорочення)
|
|
| День
|
{{CURRENTDAY}}
|
17
|
День місяця (число без вирівнювання ширини)
|
|
{{CURRENTDAY2}}
|
17
|
День місяця (число, при необхідності доповнене нулем)
|
|
{{CURRENTDOW}}
|
0
|
День тижня (число), від 0 (неділя) до 6 (субота)
|
|
{{CURRENTDAYNAME}}
|
неділя
|
День тижня (назва)
|
|
| Час
|
{{CURRENTTIME}}
|
07:38
|
Час (24-годинний формат HH:mm)
|
|
{{CURRENTHOUR}}
|
07
|
Час (24-годинний формат, число, при необхідності доповнене нулем)
|
|
| Інше
|
{{CURRENTWEEK}}
|
46
|
Тиждень (число)
|
|
{{CURRENTTIMESTAMP}}
|
20191117073824
|
Часова мітка YYYYMMDDHHmmss (відповідно до стандарту ISO 8601)
|
|
Наступні змінні мають той самий сенс, що й вищезгадані, але використовують налаштування сервера чи $wgLocaltimezone, незалежно від особистих налаштувань користувача.
{{LOCALYEAR}}{{LOCALMONTH}}{{LOCALMONTH1}}{{LOCALMONTHNAME}}{{LOCALMONTHNAMEGEN}}{{LOCALMONTHABBREV}}{{LOCALDAY}}{{LOCALDAY2}}{{LOCALDOW}}{{LOCALDAYNAME}}{{LOCALTIME}}{{LOCALHOUR}}{{LOCALWEEK}}{{LOCALTIMESTAMP}}
Для ретельнішого форматування часу, або для виведення поточного року та тижня з кращим дотриманням ISO-8601, ви можете забажати встановити Extension:ParserFunctions для використання функції парсеру #time.
Технічні метадані
Примітка: Значення змінних, що стосуються версії сторінки, завжди пов'язані з останнім редагуванням сторінки, навіть якщо ви переглядаєте старішу її версію.
| Змінна
|
Її отримане значення
|
Опис
|
Версії
|
| Сайт
|
{{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.35.0-wmf.5 (2a94d97)
|
Версія рушію MediaWiki даного вікі-проекту.
|
|
{{CONTENTLANGUAGE}}
{{CONTENTLANG}}
|
en
en
|
Мова інтерфейса по замовчуванню ($wgLanguageCode).
|
|
| Сторінка
|
{{PAGEID}}
|
298313
|
Повертає ідентифікатор сторінки.
|
|
{{PAGELANGUAGE}}
{{#language:{{PAGELANGUAGE}}}}
|
uk
українська
|
Повертає мову поточної сторінки. Код мови, що повертає цей вираз, може бути перетворений на назву мови за допомогою {{#language:...}}.
|
|
{{PROTECTIONLEVEL:дія}}
|
|
Повертає необхідний рівень дозволів (e.g. "autoconfirmed", "sysop") для заданої дії (Edit, Move тощо) на поточній сторінці, або порожній рядок для незахищеної сторінки.
|
|
{{PROTECTIONEXPIRY:дія}}
|
|
Повертає час закінчення обмеження на виконання вказаної дії (наприклад "редагувати", "перейменувати") для поточної сторінки (наприклад "20160418155030", "infinity"). Повертає "infinity", якщо на сторінку не накладено обмежень.
|
|
{{CASCADINGSOURCES}}
|
|
[Ресурсомістка] Повертає перелік джерел каскадного захисту, активних для поточної сторінки. Цей перелік не вміщуватиме назву поточної сторінки, якщо та не містить команд включення до свого тексту власних частин.
|
|
| Остання зміна поточної статті
|
{{REVISIONID}}
|
3492749
|
Унікальний ідентифікатор зміни. Порожнє в попередньому перегляді, тому можна показати повідомлення про помилку тільки в попередньому перегляді.
|
|
{{REVISIONDAY}}
|
3
|
День, коли зміна відбулася (число без вирівнювання ширини).
|
|
{{REVISIONDAY2}}
|
03
|
День, коли зміна відбулася (число, при необхідності доповнене нулем).
|
|
{{REVISIONMONTH}}
|
11
|
Місяць, коли зміна відбулася (число; при необхідності доповнене нулем - починаючи з версії 1.17+; без вирівнювання ширини - для старіших версій).
|
|
{{REVISIONMONTH1}}
|
11
|
Місяць, коли зміна відбулася (число без вирівнювання ширини).
|
|
{{REVISIONYEAR}}
|
2019
|
Рік, коли зміна відбулася.
|
|
{{REVISIONTIMESTAMP}}
|
20191103031056
|
Часова мітка останньої зміни.
|
|
{{REVISIONUSER}}
|
Shirayuki
|
Ім'я користувача, якому належить остання зміна; поточного користувача при попередньому перегляді редагованої сторінки.
|
|
{{REVISIONSIZE}}
|
95355
|
Розмір (байтів вікітексту) поточної версії сторінки.
|
|
| Впливають на вміст сторінки
|
{{DISPLAYTITLE:назва}}
{{DISPLAYTITLE:title|noerror}}
{{DISPLAYTITLE:title|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}} → 812 255, але {{NUMBEROFPAGES:R}} → 812255).
Використовуйте "|R" для магічних слів, яким потрібен параметр, подібних до PAGESINCATEGORY (приміром, {{PAGESINCATEGORY:Help}} та {{PAGESINCATEGORY:Help|R}}, або {{PAGESINCATEGORY:Help|subcats}} та {{PAGESINCATEGORY:Help|subcats|R}}). Те ж саме стосується {{PAGESIZE:назва сторінки}}, див. нижче.
Числові значення змінних форматуються залежно від мовних налаштувань вікі-проекту. Починаючи з версії MW 1.19, вони залежать від мови сторінки.
| Змінна
|
Її отримане значення
|
Опис
|
Версії
|
{{NUMBEROFPAGES}}
|
812 255
|
Кількість сторінок вікі-проекту.
|
|
{{NUMBEROFARTICLES}}
|
36 282
|
Кількість сторінок в основному просторі назв, які вважаються статтями. Подробиці див. у Manual:$wgArticleCountMethod .
|
|
{{NUMBEROFFILES}}
|
3860
|
Кількість завантажених файлів.
|
|
{{NUMBEROFEDITS}}
|
3 424 148
|
Загальна кількість змін сторінок.
|
|
{{NUMBEROFVIEWS}}
|
|
Кількість переглядів сторінки. Не має сенсу для вікі-проектів, які використовують кешування. Прибрано в Gerrit change 150699.
|
|
{{NUMBEROFUSERS}}
|
17 229 144
|
Кількість облікових записів користувачів.
|
|
{{NUMBEROFADMINS}}
|
207
|
Кількість учасників групи sysop.
|
|
{{NUMBEROFACTIVEUSERS}}
|
1171
|
Кількість активних учасників, визначених за критерієм як у Special:Statistics.
|
|
{{PAGESINCATEGORY:categoryname}}
{{PAGESINCAT:categoryname}}
|
124
124
|
[Ресурсомістка] Кількість сторінок (з підкатегоріями та файлами включно) в заданій категорії categoryname. (Category:Help використовується в якості прикладу)
|
|
{{PAGESINCATEGORY:categoryname|all}}
{{PAGESINCATEGORY:categoryname|pages}}
{{PAGESINCATEGORY:categoryname|subcats}}
{{PAGESINCATEGORY:categoryname|files}}
|
124
117
4
3
|
[Ресурсомістка] Кількість відповідно
- всіх сторінок
- звичайних сторінок (виключаючи підкатегорії та файли)
- підкатегорій
- файлів
в заданій категорії categoryname. (Category:Help використовується в якості прикладу)
|
|
{{NUMBERINGROUP:groupname}}
{{NUMINGROUP:groupname}}
|
33
33
({{NUMBERINGROUP:bureaucrat}} used here)
|
Кількість користувачів в заданій групі groupname.
|
|
{{PAGESINNS:index}}
{{PAGESINNAMESPACE:index}}
|
Вимкнено
|
[Ресурсомістка] Кількість сторінок в заданому просторі назв (замініть index відповідним номером простору назв). Приміром, {{PAGESINNAMESPACE:14}} дасть кількість сторінок категорій. {{PAGESINNS:0}} відрізняється від {{NUMBEROFARTICLES}} тим, що перша включає сторінки перенаправлень і розв'язання синтаксичних неоднозначностей. Вимкнено за замовчуванням, можна включити у $wgAllowSlowParserFunctions.
|
|
Назви сторінок
| Змінна
|
Для цієї сторінки
|
Опис
|
Версії
|
{{FULLPAGENAME}}
|
Help:Magic words/uk
|
Простір назв та повна назва сторінки (включно із усіма рівнями підсторінки).
|
|
{{PAGENAME}}
|
Magic words/uk
|
Повна назва сторінки (включно із усіма рівнями підсторінки) без простору назв.
|
|
{{BASEPAGENAME}}
|
Magic words
|
Назва сторінки без назви поточної підсторінки та без простору назв (дає "Сторінка/підсторінка" для "Довідка:Сторінка/підсторінка/код мови").
Для складнішого розщеплення назви зверніться до функції {{#titleparts:}} з розширення ParserFunctions.
|
|
{{SUBPAGENAME}}
|
uk
|
Назва поточної підсторінки (дає "код мови" для "Довідка:Сторінка/підсторінка/код мови"). Якщо підсторінки немає, повертає значення {{PAGENAME}}.
|
|
{{SUBJECTPAGENAME}}
{{ARTICLEPAGENAME}}
|
Help:Magic words/uk
Help:Magic words/uk
|
На сторінці обговорення: повна назва основної сторінки, пов'язаної з цією сторінкою обговорення.
|
|
{{TALKPAGENAME}}
|
Help talk:Magic words/uk
|
Повна назва сторінки обговорення для поточної сторінки.
|
|
{{ROOTPAGENAME}}
|
Magic words
|
Назва кореню поточної сторінки. Поверне Title для сторінки Help:Title/Foo/Bar.
|
|
На жодну з них не впливають зміни відображуваної назви, здійснені за допомогою {{DISPLAYTITLE:xxxx}}; Повернені значення є оригінальним заголовком сторінки.
Магічні слова {{BASEPAGENAME}} та {{SUBPAGENAME}} працюють лише в просторах назв, в яких дозволено підсторінки. Про дозвіл підсторінок див. $wgNamespacesWithSubpages.
Починаючи з версії MW 1.15+, всі ці змінні можуть приймати параметр, яким можна задати назву сторінки, яка (замість поточної) визначить значення змінної:
{{PAGENAME:Template:Main Page}} → Main Page
 Увага: | Якщо назва сторінки містить частини "." або ".." (між знаками "/"), магічне слово не спрацює і нічого не поверне.
{{PAGENAME:one/./three}} → '. Нічого не повертається.
|
| Увага: | Назви сторінок, що містять певні символи, такі як апостроф ' чи зірочка *, можуть при роботі з цими змінними продукувати неочікувані результати, такі як {{PAGESINCATEGORY:{{PAGENAME}}}}. Див. повідомлення про помилки T16779, T18474, T37628, T37746. Простим способом запобігти цьому є екранування назви сторінки функцією парсера {{#titleparts:}} (Help:Extension:ParserFunctions). |
Кодування назви сторінки в 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+, ці функції можуть приймати як параметр повну назву сторінки замість поточної:
{{NAMESPACENUMBER:MediaWiki}} → 0{{NAMESPACE:MediaWiki}} → (Pages in main space will return empty){{NAMESPACE:Template:Main Page}} → Template{{SUBJECTSPACE:Template:Main Page}} → Template{{ARTICLESPACE:Template:Main Page}} → Template{{TALKSPACE:Template:Main Page}} → Template talk
Цей параметр не повинен бути назвою простору назв:
{{SUBJECTSPACE:Help talk}} → (Empty)
Інше
| Змінна
|
Її отримане значення
|
Опис
|
Версії
|
{{!}}
|
|
|
Використовується для того, щоб включити символ вертикальної риски як частину аргументу шаблону чи комірки таблиці. Поки це магічне слово не було реалізоване, багато вікі-проектів розв'язували таку задачу створенням шаблону Template:!, який містив єдиний символ |.
|
|
Функції парсера
Функції парсера (синтаксичного аналізатора вікітексту) дуже подібні до змінних, але приймають один чи більше параметрів. З технічної точки зору, будь-яке магічне слово, що приймає аргумент, є функцією парсера. Їхнім назвам інколи передує символ решітки "#", щоб відрізнити їх від звернення до шаблонів.
Ця стаття описує лише функції парсера, які вбудовані в код MediaWiki. Будь-які інші функції парсера можуть бути додані розширеннями MediaWiki (MediaWiki Extentions), такими як Extension:ParserFunctions ; документація на відповідних сторінках довідки (Help:Extension:ParserFunctions ).
Технічні метадані іншої сторінки
| Функція парсера
|
Її отримане значення
(для сторінки MediaWiki)
|
Опис
|
Версії
|
{{PAGEID: назва сторінки }}
|
1
|
[Ресурсомістка] Повертає ідентифікатор вказаної сторінки*.
|
|
{{PAGESIZE:назва сторінки}}
{{PAGESIZE: назва сторінки |R}}
|
176
176
|
[Ресурсомістка] Дає розмір в байтах вказаної сторінки. Використовуйте "|R" для отримання неформатованого числа (без групування розрядів).
|
|
{{PROTECTIONLEVEL:дія | page name}}
|
sysop
|
[Ресурсомістка] Повертає необхідний рівень доступу (e.g. "autoconfirmed", "sysop") для заданої дії (Edit, Move тощо) на вказаній сторінці, або порожній рядок для незахищеної сторінки.
|
|
{{PROTECTIONEXPIRY:
action |
page name}}
|
infinity
|
[Ресурсомістка] Виводить закінчення терміну захисту (наприклад, «20160418155030», «infinity») від даної дії (наприклад, «редагування», «перейменування») на конкретній сторінці. Повертає «infinity», якщо незахищена.
|
|
{{CASCADINGSOURCES: page name}}
|
|
[Ресурсомістка] Повертає перелік джерел каскадного захисту, активних на вказаній сторінці. Цей перелік не вміщуватиме назву вказаної сторінки, якщо та не містить команд включення власних частин.
|
|
{{REVISIONID: page name }}
|
3439858
|
[Ресурсомістка] Дає унікальний ідентифікатор останньої зміни вказаної сторінки*.
|
|
{{REVISIONDAY: page name }}
|
3
|
[Ресурсомістка] Дає день останньої зміни вказаної сторінки* (число, без вирівнювання).
|
|
{{REVISIONDAY2: page name }}
|
03
|
[Ресурсомістка] Дає день останньої зміни вказаної сторінки* (число, при необхідності доповнене нулем).
|
|
{{REVISIONMONTH: page name }}
|
10
|
[Ресурсомістка] Дає місяць останньої зміни вказаної сторінки* (число, при необхідності доповнене нулем, починаючи з версії 1.17+; число без вирівнювання для старіших версій).
|
|
{{REVISIONMONTH1: page name }}
|
10
|
[Ресурсомістка] Дає місяць останньої зміни вказаної сторінки* (число, без вирівнювання).
|
|
{{REVISIONYEAR: page name }}
|
2019
|
[Ресурсомістка] Дає рік останньої зміни вказаної сторінки*.
|
|
{{REVISIONTIMESTAMP: page name }}
|
20191003091610
|
[Ресурсомістка] Дає часову мітку останньої зміни вказаної сторінки*.
|
|
{{REVISIONUSER: page name }}
|
AKlapper (WMF)
|
[Ресурсомістка] Дає ім'я користувача, якому належить остання зміна вказаної сторінки*.
|
|
| *Якщо вказаний параметр збігається з назвою поточної сторінки, функції парсера даватимуть інформацію про попередню версію сторінки в разі попереднього перегляду та підстановки (порожні строки при створенні сторінки). При звичайному перегляді (включно з переглядом минулих версій) функції даватимуть інформацію про поточну сторінку і можуть не вважатися витратними.
|
Дані URL
| Функція парсера
|
Приклад → Результат
|
Опис
|
Версії
|
|
|
{{localurl:назва сторінки}}
{{localurl:назва сторінки
|рядок_запиту}}
|
{{localurl:MediaWiki}}
→ /wiki/MediaWiki
{{localurl:MediaWiki|printable=yes}}
→ /w/index.php?title=MediaWiki&printable=yes
|
Відносний шлях до назви сторінки, з опціональним параметром query_string.
|
|
|
|
{{fullurl:назва сторінки}}
{{fullurl:назва сторінки
|рядок_запиту}}
{{fullurl:interwiki:назва віддаленої сторінки
|рядок_запиту}}
|
{{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
|
Веб-посилання на сторінку без уточнення протоколу, яке залежить від конфігурації $wgServer для локальної вікі (і таким чином можуть або починатися із префіксу http(s)://, або бути без префікса). Дозволено префікси інтервікі. Примітка: якщо таке посилання не взяте в квадратні дужки, воно не буде автоматично зроблено активним.
|
|
|
|
{{canonicalurl:назва сторінки}}
{{canonicalurl:назва сторінки
|рядок_запиту}}
{{canonicalurl:interwiki:назва віддаленої сторінки
|рядок_запиту}}
|
{{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:ім'я файлу}}
{{filepath:ім'я файлу|nowiki}}
{{filepath:ім'я файлу|розмір_мініатюри}}
|
{{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
The parameter nowiki usually removes the link around the filepath (which can't be seen in this example).
|
Шлях до ескізу (1.18+) медіа-файлу без уточнення протоколу.
|
|
|
|
{{urlencode:string}} або
{{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:StringFunctions ).
Кодування| кодування | пробіл |
|---|
| 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 лише перетворить цифри для мов, які не використовують Індо-арабську систему числення. Він також запобігає нестандартному групуванню розрядів, якого ви не чекаєте.
| Увага: | Нулі на початку числа не видаляються, тут слід користатися {{#expr:00001}}, якщо встановлено розширення Extension:ParserFunctions . |
| Увага: | У випадку неправильного формату аргументу не очікуйте від функції змістовного результату, особливо для неангломовних проектів. |
Якщо ж конче необхідно розмітити число з невідомого вихідного формату у відповідності з діючим мовним налаштуванням, спробуйте застосувати 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:StringFunctions .
Локалізація
Ці магічні слова застосовуються як основні інструменти локалізації. Деякі магічні слова залежатимуть від мовного та інших налаштувань вікі-проекту або від обраної користувачем мови: див. #Date and time, #Formatting, #Miscellaneous тощо. Додаткові магічні слова визначені у Розширення: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) використовують три форми множини ( оновлено в січні 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:|) визначає поточного користувача, але може використовуватись тільки в повідомленнях інтерфейсу (простір імен MediaWiki).
Крапка (.) замість імені користувача визначає гендер користувача по замовчуванню, налаштований у вікі-проекті.
|
|
{{int:назва повідомлення}}
|
{{int:edit}} → Edit
(Залежить від обраної користувачем мови; спробуйте: fr • ja)
|
Інтернаціоналізує (перекладає) задане параметром інтерфейсне (interface) повідомлення із простору імен MediaWiki мовою користувача. Про msgnw та інші магічні слова, пов'язані зі включенням, див. розділ Модифікатори включення сторінок. "Зауважте, що це може пошкодити/переплутати посилання в кеші у MediaWiki версії 1.17 чи старішій, див. T16404.
|
|
{{int:editsectionhint|MediaWiki}}
|
{{int:editsectionhint|MediaWiki}} → Edit section: MediaWiki
|
Ви також можете використовувати параметри для перекладу.
Параметри позначаються у повідомленнях так: $1, $2, $3 тощо. Приміром, ось повідомлення для 'editsectionhint: Edit section: $1
В цьому прикладі MediaWiki замінить $1.
|
|
Модифікатори включення сторінок
{{Назва сторінки|необов'язкові параметри}} зазвичай включає до сторінки вміст іншої сторінки, за замовчуванням зміст із простору назв "Шаблон".
Ці магічні слова змінюють спосіб включення.
| Використання
|
Результат
|
Опис
|
Версія
|
{{:xyz}}
|
|
Двокрапка не є модифікатором шаблона, а є префіксом який позначає використання основного простору назв. Оскільки за замовчуванням включаються сторінки з простору назв "Шаблон", слів використовувати, наприклад, {{:UTC}} (а не {{UTC}}) для включення тексту зі сторінки UTC з основного простору назв, замість включення сторінки Шаблон:UTC.
|
|
{{int:xyz}}
|
|
Те саме що і {{MediaWiki:xyz}}, окрім того що стандартне повідомлення залежить від підсторінок та мови вмісту/користувача/uselang. Ще одною відмінністю є те що воно не з'являється в списку "Шаблони, використані на цій сторінці:". Показується як ⧼xyz⧽ якщо MediaWiki:xyz не існує. Див. також Help:System message .
|
|
{{msg:xyz}}
{{raw:xyz}}
|
|
Навіть якщо існує магічне слово "xyz", використовує Шаблон:xyz (окрім випадків коли шаблон не існує). Є еквівалентним до {{template:xyz}}. Зазвичай, магічні слова мають пріоритет.
|
|
{{raw:xyz}}
|
|
Якщо $wgEnableScaryTranscluding є включеним та даний випадок є міжсайтовим включенням, включає вікітекст заміть HTML-коду.
|
|
{{msgnw:xyz}}
|
|
Включає неперетворений вікітекст (певною мірою, для деталей див. Help:Template#Usage ).
|
|
{{subst:xyz}}
|
|
У вікітексті замінюється на вміст сторінки (із одним рівнем обчислень), див. Help:Template#Usage .
|
|
{{safesubst:xyz}}
|
|
Див. Help:Template#Usage .
|
|
Інше
| Використання
|
Результат
|
Опис
|
Версії
|
{{#language:language code}}
{{#language:ar}}
{{#language:language code|
target language code}}
{{#language:ar|en}}
|
language code
العربية
language code
Arabic
|
Повна назва мови для заданого коду мови: за замовчуванням власна природна назва, перекладена цільовою мовою, якщо код цільової мова вказано після вертикальної риски. До цієї функції дає доступ розширення Extension: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: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}}. Пробіли на початку і в кінці області між вертикальними рисками ||, зарезервованій для вмісту, не дозволено. |
|
|
Увага: 
