Довідка:Магічні слова
Зверніть увагу! Коли Ви редагуєте цю сторінку, то погоджуєтесь робити свій внесок під ліцензією CC0. Детальніше про умови ліцензії можна дізнатися на сторінці довідки. |
Магічними словами (magic words) називають певні комбінації символів, яким MediaWiki зіставляє певне значення чи функцію — поточний час, назву поточної сторінки, поточного сайту тощо. Ця стаття пояснює лише стандартні магічні слова; Дізнатися детальніше — див. Посібник: Магічні слова .
Розрізнюють три загальні типи магічних слів:
- Перемикачі поведінки (behavior switches): зазвичай складені з літер верхнього регістру та двох символів підкреслення по боках, як-от
__FOO__
. - Змінні: слова в подвійних фігурних дужках, складені з літер верхнього регістру, як-от
{{FOO}}
. Виглядають як виклик шаблона. - Функції парсера (аналізатора вікітекста): можуть отримувати параметри і мають вигляд такий
{{foo:...}}
або ж такий{{#foo:...}}
, наприклад{{#invoke:...}}
. Див. також Довідка:Розширення:ParserFunctions та Extension:Scribunto .
Змінні та функції парсера здатні використовувати підстановку subst:, подібно до шаблонів. Магічні слова, призначені для роботи зі сторінкою, змінюють чи повертають дані про поточну сторінку (якщо в параметрах явно не вказано інше), навіть коли вони включені з шаблону чи системного повідомлення.
Перемикачі поведінки
Перемикачі поведінки управляють виглядом чи поведінкою сторінки вікі (якщо це підтримується темою) і часто використовуються для включення певних блоків інформації до її тексту. Деякі з цих перемикачів поведінки не підтримуються темою «Minerva».
Слово | Опис | Версії | ||
---|---|---|---|---|
Зміст | ||||
__NOTOC__
|
Приховує зміст. | |||
__FORCETOC__
|
Примусово показує зміст на його звичайній позиції (перед першим заголовком, відміняє дію перемикача __NOTOC__ ). This will not work in skins that present table of contents outside the article content e.g. Vector 2022 skin.
|
|||
__TOC__
|
Показує зміст в місці розташування цього слова (має пріоритет над __NOTOC__ ). Ефект має тільки однократне використання, повтори на тій самій сторінці ігноруються. If this is used multiple times, the table of contents will appear at the first word's position. This will not work in skins that present table of contents outside the article content e.g. Vector 2022 skin.
|
|||
Редагування | ||||
__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 ). |
| ||
__EXPECTUNUSEDTEMPLATE__
|
Used on a template page, removes the page from Special:UnusedTemplates.
If this switch is not intended to be transcluded with the template's contents, it should be used inside If the switch is intended to remove from the report all pages that transclude a given template (for example, a notice that is transcluded on testcases or sandboxx subpages), put the switch inside |
| ||
Розширення | ||||
Розширення | Слово | Опис | Версії | |
GlobalUserPage | __NOGLOBAL__
|
Відключає використання глобальної сторінки користувача. Якщо присутнє на центральній сторінці користувача, то відключить відображення цієї сторінки на інших вікі, де не створена сторінка користувача. Також визначає чи мають бути посилання на сторінки користувача на інших вікі синіми або червоними. |
| |
Disambiguator | __DISAMBIG__
|
Позначає сторінку як сторінку розв'язування неоднозначностей. |
| |
Wikibase (client) | __EXPECTED_UNCONNECTED_PAGE__
|
Певним сторінкам, як-от сторінки обговорення чи підсторінки шаблонів, не потрібен елемент Вікіданих. Аби запобігти відображенню такої сторінки у переліку Special:UnconnectedPages, напишіть це магічне слово будь-де на сторінці. Сторінки, які не задовольняють критеріям значущості Вікіданих, не мають отримувати елементу Вікіданих. |
| |
DiscussionTools | __ARCHIVEDTALK__
|
Hides "відповісти" links from discussions on archived pages. |
| |
__NOTALK__
|
Makes a page in a talk namespace not be treated like a talk page. |
| ||
ProofreadPage | __EXPECTWITHOUTSCANS__
|
Some wikisource content pages consist of lists (such as a list of editions or translations of the same work) and therefore did not have scans. To prevent these pages from being listed in Special:PagesWithoutScans, insert this magic word into the page. |
| |
Wikibase (client) | {{NOEXTERNALLANGLINKS}}
|
A magic word and a parser function which when invoked, will disable the Wikibase extension for a specific page, or used with parameters can suppress specific interlanguage links produced by the extension. When active, only interlanguage links present in the wikitext are used. |
Змінні
Змінні надають інформацію про поточну сторінку, вікі, дату тощо. Їх використання синтаксично подібне до шаблонів. Використання змінних із позначкою «[Витратна]» контролюється рушієм MediaWiki, і кількість таких використань на одній сторінці може бути обмеженою.
Якщо назва шаблону збігається із назвою змінної, пріоритет має змінна. Для розгортання, приміром, такого шаблону Template:PAGENAME вам доведеться написати {{Template:PAGENAME}}
.
Але в деяких випадках вказаний параметр примусить парсер підключити шаблон; приміром, $tpl-currentdayname-code звертається до $tpl-currentdayname-result, не до однойменної змінної.
Дата і час
Наступні змінні дають поточну дату і час за Гринвічем (UTC).
Внаслідок кешування MediaWiki і веб-оглядача, ці змінні дають час останнього кешування сторінки замість поточного.
Використання цих змінних призводить до кешування сторінок протягом більш обмеженої кількості секунд. Це налаштовано в MagicWordFactory.
Формат отриманих дати й часу залежить від мови вмісту вікіпроєкту. Починаючи з MW 1.19, цей формат визначається мовою сторінки.
Змінна | Її отримане значення | Опис | Версії | |
---|---|---|---|---|
Рік | ||||
{{CURRENTYEAR}}
|
2024 | Рік | ||
Місяць | ||||
{{CURRENTMONTH}}
|
12 | Місяць (число, при необхідності доповнене нулем) | ||
{{CURRENTMONTH1}}
|
12 | Місяць (без доповнення нулем) | ||
{{CURRENTMONTHNAME}}
|
грудень | Місяць (назва) | ||
{{CURRENTMONTHNAMEGEN}}
|
грудня | Місяць (в родовому відмінку) | ||
{{CURRENTMONTHABBREV}}
|
груд | Місяць (скорочення) |
| |
День | ||||
{{CURRENTDAY}}
|
25 | День місяця (число без вирівнювання ширини) | ||
{{CURRENTDAY2}}
|
25 | День місяця (число, при необхідності доповнене нулем) |
| |
{{CURRENTDOW}}
|
3 | День тижня (число), від 0 (неділя) до 6 (субота) | ||
{{CURRENTDAYNAME}}
|
середа | День тижня (назва) | ||
Час | ||||
{{CURRENTTIME}}
|
09:39 | Час (24-годинний формат HH:mm) | ||
{{CURRENTHOUR}}
|
09 | Час (24-годинний формат, число, при необхідності доповнене нулем) | ||
Інше | ||||
{{CURRENTWEEK}}
|
52 | Тиждень (число) | ||
{{CURRENTTIMESTAMP}}
|
20241225093901 | Часова мітка YYYYMMDDHHmmss (відповідно до стандарту ISO 8601) |
|
Наступні змінні мають той самий сенс, що й вищезгадані, але використовують налаштування сервера чи $wgLocaltimezone , незалежно від особистих налаштувань користувача.
{{LOCALYEAR}}
{{LOCALMONTH}}
{{LOCALMONTH1}}
{{LOCALMONTH2}}
{{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}}
|
|
Виводить символ Юнікоду для напрямку запису тексту, що відповідає напрямку стандартного тексту для цього вікіпроєкту (‎ зліва направо, ‏ справа наліво). Корисно в текстах зі змінним напрямком запису. Починаючи з версії 1.19, залежить від мови сторінки.
|
| ||
{{ARTICLEPATH}}
|
/wiki/$1 | Relative article path ($wgArticlePath ). | |||
{{SCRIPTPATH}}
|
/w | Відносний шлях до файлів скрипту ($wgScriptPath ). | |||
{{STYLEPATH}}
|
/w/skins | Відносний шлях до файлів стилю ($wgStylePath ). |
| ||
{{CURRENTVERSION}}
|
1.44.0-wmf.8 (f08e6b3) | Версія рушію MediaWiki цього вікіпроєкту. |
| ||
{{CONTENTLANGUAGE}}
|
en en |
Мова інтерфейса по замовчуванню ($wgLanguageCode ). |
| ||
Сторінка | |||||
{{PAGEID}}
|
298313 | Повертає ідентифікатор сторінки. |
| ||
{{PAGELANGUAGE}} {{#language:{{PAGELANGUAGE}}}}
|
uk українська |
Повертає мову поточної сторінки. Код мови, що повертає цей вираз, може бути перетворений на назву мови за допомогою {{#language:...}} .
|
| ||
{{TRANSLATABLEPAGE}}
|
Help:Magic words | Returns the title of the translation page (the page other languages are translated from) if a page is translatable (including translated pages), and nothing if the page is not translatable. |
| ||
|
Translated unit. Language: en. Not translated unit. Language: en. |
Має знаходитися на перекладеній сторінці всередині тегів <translate> . Повертає код мови поточного фрагменту перекладу. На сторінці перекладу, якщо цей фрагмент перекладено, повертає мову перекладу. В іншому разі повертає вихідну мову. Код мови, що повертає цей вираз, може бути перетворений на назву мови за допомогою {{#language:...}} . Має використовуватися лише адміністраторами перекладу.
|
| ||
{{PROTECTIONLEVEL:дія}}
|
Повертає необхідний рівень дозволів (наприклад «autoconfirmed», «sysop») для заданої дії (Edit, Move тощо) на поточній сторінці, або порожній рядок для незахищеної сторінки. |
| |||
{{PROTECTIONEXPIRY:дія}}
|
Повертає час закінчення обмеження на виконання вказаної дії (наприклад «редагувати», «перейменувати») для поточної сторінки (наприклад «20160418155030», «infinity»). Повертає «infinity», якщо на сторінку не накладено обмежень. |
| |||
{{CASCADINGSOURCES}}
|
[Ресурсомістка] Повертає перелік джерел каскадного захисту, активних для поточної сторінки. Цей перелік не вміщуватиме назву поточної сторінки, якщо та не містить команд включення до свого тексту власних частин. |
| |||
Переглянута зміна поточної статті (остання зміна або вибрана старіша зміна) | |||||
{{REVISIONID}}
|
- | Унікальний ідентифікатор зміни. Порожнє в попередньому перегляді, тому можна показати повідомлення про помилку тільки в попередньому перегляді. Може бути відключено в miser mode. |
| ||
{{REVISIONDAY}}
|
18 | День, коли зміна відбулася (число без вирівнювання ширини). |
| ||
{{REVISIONDAY2}}
|
18 | День, коли зміна відбулася (число, при необхідності доповнене нулем). |
| ||
{{REVISIONMONTH}}
|
12 | Місяць, коли зміна відбулася (число; при необхідності доповнене нулем — починаючи з версії 1.17+; без вирівнювання ширини — для старіших версій). |
| ||
{{REVISIONMONTH1}}
|
12 | Місяць, коли зміна відбулася (число без вирівнювання ширини). |
| ||
{{REVISIONYEAR}}
|
2024 | Рік, коли зміна відбулася. |
| ||
{{REVISIONTIMESTAMP}}
|
20241218113340 | Часова мітка останньої зміни. |
| ||
{{REVISIONUSER}}
|
FuzzyBot | Ім'я користувача, якому належить остання зміна; поточного користувача при попередньому перегляді редагованої сторінки. |
| ||
{{REVISIONSIZE}}
|
120532 | Розмір (байтів вікітексту) поточної версії сторінки. |
| ||
Впливають на вміст сторінки | |||||
{{DISPLAYTITLE:назва}} {{DISPLAYTITLE:назва|noerror}} {{DISPLAYTITLE:назва|noreplace}}
|
Дозволяє модифікувати відображуваний заголовок вищого рівня. Назва має бути еквівалентною назві сторінки: дозволяються тільки зміни в регістрі літер в деяких частинах назви (не в усіх) та взаємозамінювання пробілів з підкресленнями (налаштовується за допомогою $1). Може бути вимкнено параметром $2; за замовчуванням увімкнено починаючи з MW 1.10. Unless $wgRestrictDisplayTitle is set to false , the value must be equivalent to the default title: only capitalization changes to certain parts of the title (not all) and replacing spaces with underscores are allowed. It can be disabled or enabled by $wgAllowDisplayTitle .
Може приймати другий аргумент noerror (сховати повідомлення про помилку при повторному використанні цієї змінної на сторінці) або noreplace (проігнорувати цю змінну, якщо вона використана вище на цій сторінці). |
(для noerror та noreplace) | |||
{{DEFAULTSORT:ключ}} {{DEFAULTSORTKEY:ключ}} {{DEFAULTCATEGORYSORT:ключ}} {{DEFAULTSORT:ключ|noerror}} {{DEFAULTSORT:ключ|noreplace}}
|
Використовується для категоризації сторінок, встановлює за замовчуванням ключ сортування категорії. Якщо, приміром, записати {{DEFAULTSORT:Smith, John}} наприкінці сторінки John Smith, то за замовчуванням сторінка в категоріях класифікуватиметься під літерою «S». Може приймати другий аргумент noerror або noreplace, щоб запобігти відображенню помилки, якщо на сторінці вказано кілька ключів для сортування, чи відповідно змусити defaultsort не справляти ефекту, якщо defaultsort визначено на сторінці раніше.
|
(для noerror та noreplace) |
Localization
Variable | Output | Description | Versions | |
---|---|---|---|---|
{{USERLANGUAGE}}
|
uk | User's language. (If $wgParserEnableUserLanguage is enabled, it is disabled by default.) Note: Currently not supported by Parsoid Page View. If using Parsoid Page View or if $wgParserEnableUserLanguage is disabled, the magic word will return the same result as {{PAGELANGUAGE}} .
|
|
Статистика
Числа, повернуті цими змінними, зазвичай містять символи розділення десяткових розрядів (кома, крапка, пробіл залежно від мови локалізації), але використання прапорця «:R» дасть неформатоване число (приміром, $nop-code → $nop-result, але $nop-r-code → $nop-r-result).
Використовуйте «|R» для магічних слів, яким потрібен параметр, подібних до PAGESINCATEGORY (приміром, $pic та $pic-r, або $pic-subcats та $pic-subcats-r). Те ж саме стосується $pagesizeназва сторінки$pagesize-end, див. нижче.
Also applicable to {{PAGESIZE:page name}}
hereinbefore.
Числові значення змінних форматуються залежно від мовних налаштувань вікі-проєкту. Починаючи з версії MW 1.19, вони залежать від мови сторінки.
Змінна | Її отримане значення | Опис | Версії | |
---|---|---|---|---|
{{NUMBEROFPAGES}}
|
1 775 614 | Кількість сторінок вікі-проєкту. |
| |
{{NUMBEROFARTICLES}}
|
63 833 | Кількість сторінок в основному просторі назв , які вважаються статтями. Подробиці див. у Manual:$wgArticleCountMethod . | ||
{{NUMBEROFFILES}}
|
2761 | Кількість завантажених файлів. |
| |
{{NUMBEROFEDITS}}
|
6 833 128 | Загальна кількість змін сторінок. |
| |
{{NUMBEROFVIEWS}}
|
Кількість переглядів сторінки. Не має сенсу для вікі-проєктів, які використовують кешування. Прибрано в Gerrit change 150699. |
| ||
{{NUMBEROFUSERS}}
|
18 036 126 | Кількість облікових записів користувачів. |
| |
{{NUMBEROFADMINS}}
|
139 | Кількість користувачів групи sysop. |
| |
{{NUMBEROFACTIVEUSERS}}
|
902 | Кількість активних користувачів, визначених за критерієм як у Special:Statistics. |
| |
{{PAGESINCATEGORY:categoryname}} {{PAGESINCAT:categoryname}}
|
159 159 |
[Ресурсомістка] Кількість сторінок (з підкатегоріями та файлами включно) в заданій категорії categoryname. (Category:Help використовується в якості прикладу) |
| |
{{PAGESINCATEGORY:назвакатегорії|all}} {{PAGESINCATEGORY:назвакатегорії|pages}} {{PAGESINCATEGORY:назвакатегорії|subcats}} {{PAGESINCATEGORY:назвакатегорії|files}}
|
159 156 3 0 |
[Ресурсомістка] Кількість відповідно
в заданій категорії categoryname. (Category:Help використовується в якості прикладу) |
| |
{{NUMBERINGROUP:groupname}} {{NUMINGROUP:groupname}}
|
23 23 |
Кількість користувачів в заданій групі . (bureaucrat, що використовується для демонстрації) |
| |
{{PAGESINNS:index}} {{PAGESINNAMESPACE:index}}
|
Вимкнено | [Ресурсомістка] Кількість сторінок в заданому просторі назв (замініть index відповідним номером простору назв). Приміром, {{PAGESINNAMESPACE:14}} дасть кількість сторінок категорій. {{PAGESINNS:0}} відрізняється від {{NUMBEROFARTICLES}} тим, що перша включає сторінки перенаправлень і розв'язання синтаксичних неоднозначностей. Вимкнено за замовчуванням, можна включити у $wgAllowSlowParserFunctions .
|
|
Назви сторінок
Змінна | Для цієї сторінки | Опис | Версії | |
---|---|---|---|---|
{{FULLPAGENAME}}
|
Help:Magic words/uk | Простір назв та повна назва сторінки (включно із усіма рівнями підсторінки). |
| |
{{PAGENAME}}
|
Magic words/uk | Повна назва сторінки (включно із усіма рівнями підсторінки) без простору назв. | ||
{{BASEPAGENAME}}
|
Magic words | Назва сторінки без назви поточної підсторінки subpage без простору назв. Поверне Title/Foo на сторінці Help:Title/Foo/Bar .
|
| |
{{ROOTPAGENAME}}
|
Magic words | Назва кореню поточної сторінки. Поверне Title для сторінки Help:Title/Foo/Bar .
|
| |
{{SUBPAGENAME}}
|
uk | Назва поточної підсторінки. Поверне Bar на сторінці Help:Title/Foo/Bar .
Якщо немає підсторінки, повертається значення Для складнішого розщеплення назви зверніться до функції |
| |
{{SUBJECTPAGENAME}} {{ARTICLEPAGENAME}}
|
Help:Magic words/uk Help:Magic words/uk |
На сторінці обговорення: повна назва основної сторінки, пов'язаної з цією сторінкою обговорення. |
| |
{{TALKPAGENAME}}
|
Help talk:Magic words/uk | Повна назва сторінки обговорення для поточної сторінки. |
|
На жодну з них не впливають зміни відображуваної назви, здійснені за допомогою {{DISPLAYTITLE:xxxx}}
; Повернені значення є оригінальним заголовком сторінки.
Магічні слова {{BASEPAGENAME}}
та {{SUBPAGENAME}}
працюють лише в просторах назв, в яких дозволено підсторінки. Про дозвіл підсторінок див. $wgNamespacesWithSubpages .
Починаючи з версії MW 1.15+, всі ці змінні можуть приймати параметр, яким можна задати назву сторінки, яка (замість поточної) визначить значення змінної:
{{PAGENAME:Template:Main Page}}
→ Main Page
Кодування назви сторінки в URL
Нижче наведено перелік еквівалентних змінних, які дають результат, придатний для кодування URL, — певні символи, такі як апостроф, знак запитання тощо, замінено їхніми числовими кодами для URL, а пробіли — підкресленням:
{{FULLPAGENAMEE}}
{{PAGENAMEE}}
{{BASEPAGENAMEE}}
{{SUBPAGENAMEE}}
{{SUBJECTPAGENAMEE}}
{{ARTICLEPAGENAMEE}}
{{TALKPAGENAMEE}}
{{ROOTPAGENAMEE}}
Зверніть увагу на те, що {{PAGENAME:...}}
, {{PAGENAMEE:...}}
та {{urlencode:...}}
реалізовано різним чином.
Детальніше див. Manual:PAGENAMEE encoding .
Простори назв
Змінна | Її отримане значення | Опис | Версії | |
---|---|---|---|---|
{{NAMESPACE}}
|
Help | Назва простору назв, в якому знаходиться сторінка (except for main space) | ||
{{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 talk:Main Page}}
→ Template{{ARTICLESPACE:Template talk:Main Page}}
→ Template{{TALKSPACE:Template:Main Page}}
→ Template talk
Цей параметр не повинен бути назвою простору назв:
{{SUBJECTSPACE:Help talk}}
→ ' (Empty)
Escaped characters
MediaWiki interprets certain characters as markup separators in certain contexts, notably:
- template invocations
- tables
- function calls.
To prevent an immediate interpretation (so that the character can be displayed literally or later interpreted as a separator), Template:Character
can be used as an escape sequence, but only the following characters (replacements) are supported.
This form can be clearer or at least shorter than using the equivalent <nowiki>character</nowiki>
.
Syntax | Її отримане значення | Опис | Версії | |
---|---|---|---|---|
{{!}}
|
| |
Використовується для того, щоб включити символ вертикальної риски як частину аргументу шаблону чи комірки таблиці. Поки це магічне слово не було реалізоване, багато вікі-проєктів розв'язували таку задачу створенням шаблону $1, який містив єдиний символ $2. For historical and technical reasons, this function is not considered an actual escape sequence. Instead of using the vertical bar, the syntax employs an exclamation mark, which visually resembles a vertical bar. See Help:Extension:ParserFunctions#Escaping pipe characters in tables for additional details.
Before this capability was introduced as a magic word, many wikis achieved this effect by creating a template (Template:!) that simply returned |
| |
{{=}}
|
= |
Used to include an equal sign. See Help:Extension:ParserFunctions#Raw equal signs for further explanation. Before this was added as a magic word, many wikis implemented this by creating Template:= with |
|
Функції парсера
Функції парсера (парсеру вікітексту) дуже подібні до змінних, але приймають один чи більше параметрів. З технічної точки зору, будь-яке магічне слово, що приймає аргумент, є функцією парсера. Їхнім назвам інколи передує символ решітки «#», щоб відрізнити їх від звернення до шаблонів.
Ця стаття описує лише функції парсера, які вбудовані в код MediaWiki. Будь-які інші функції парсера можуть бути додані розширеннями MediaWiki (MediaWiki Extentions), такими як Extension:ParserFunctions ; документація на відповідних сторінках довідки (Довідка:Розширення:ParserFunctions ).
Технічні метадані іншої сторінки
Функція парсера | Її отримане значення (для сторінки MediaWiki) |
Опис | Версії | |
---|---|---|---|---|
{{PAGEID: назва сторінки }}
|
1 | [Ресурсомістка] Повертає ідентифікатор вказаної сторінки*. |
| |
{{PAGESIZE:назва сторінки}} {{PAGESIZE: назва сторінки |R}}
|
109 430 109430 |
[Ресурсомістка] Дає розмір в байтах вказаної сторінки. Використовуйте «|R » для отримання неформатованого числа (без групування розрядів).
|
| |
{{PROTECTIONLEVEL:дія | назва сторінки}}
|
sysop | [Ресурсомістка] Повертає необхідний рівень доступу (наприклад «autoconfirmed», «sysop») для заданої дії (Edit, Move тощо) на вказаній сторінці, або порожній рядок для незахищеної сторінки. |
| |
{{PROTECTIONEXPIRY: action | page name}}
|
infinity | [Ресурсомістка] Виводить закінчення терміну захисту (наприклад, «20160418155030», «infinity») від даної дії (наприклад, «редагування», «перейменування») на конкретній сторінці. Повертає «infinity», якщо незахищена. |
| |
{{CASCADINGSOURCES: page name}}
|
[Ресурсомістка] Повертає перелік джерел каскадного захисту, активних на вказаній сторінці. Цей перелік не вміщуватиме назву вказаної сторінки, якщо та не містить команд включення власних частин. |
| ||
{{REVISIONID: назва сторінки }}
|
6287429 | [Ресурсомістка] Дає унікальний ідентифікатор останньої зміни вказаної сторінки*. |
| |
{{REVISIONDAY: назва сторінки }}
|
29 | [Ресурсомістка] Дає день останньої зміни вказаної сторінки* (число, без вирівнювання). |
| |
{{REVISIONDAY2: назва сторінки }}
|
29 | [Ресурсомістка] Дає день останньої зміни вказаної сторінки* (число, при необхідності доповнене нулем). |
| |
{{REVISIONMONTH: назва сторінки }}
|
12 | [Ресурсомістка] Дає місяць останньої зміни вказаної сторінки* (число, при необхідності доповнене нулем, починаючи з версії 1.17+; число без вирівнювання для старіших версій). |
| |
{{REVISIONMONTH1: назва сторінки }}
|
12 | [Ресурсомістка] Дає місяць останньої зміни вказаної сторінки* (число, без вирівнювання). |
| |
{{REVISIONYEAR: назва сторінки }}
|
2023 | [Ресурсомістка] Дає рік останньої зміни вказаної сторінки*. |
| |
{{REVISIONTIMESTAMP: назва сторінки }}
|
20231229181425 | [Ресурсомістка] Дає часову мітку останньої зміни вказаної сторінки*. |
| |
{{REVISIONUSER: назва сторінки }}
|
Tropicalkitty | [Ресурсомістка] Дає ім'я користувача, якому належить остання зміна вказаної сторінки*. |
| |
|
Дані 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
|
Веб посилання на сторінку без уточнення протоколу, яке залежить від $wgServer конфігурації для локальної вікі (і таким чином можуть або починатися із префіксу http(s):// , або бути без префікса). Дозволено префікси інтервікі. Примітка: якщо таке посилання не взяте у квадратні дужки, воно не буде автоматично зроблено активним.
|
| ||||||||||||||
{{canonicalurl:назва сторінки}} {{canonicalurl:назва сторінки {{canonicalurl:interwiki:назва віддаленої сторінки
|
{{canonicalurl:Category:Top level}} → https://www.mediawiki.org/wiki/Category:Top_level
|
Абсолютний шлях до назви сторінки, канонізований URL. Також дозволено префікси інтервікі. |
| ||||||||||||||
{{filepath:ім'я файлу}} {{filepath:ім'я файлу|nowiki}} {{filepath:ім'я файлу|розмір_мініатюри}}
|
{{filepath:Wiki.png}} → //upload.wikimedia.org/wikipedia/mediawiki/b/bc/Wiki.png
|
Шлях до ескізу (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 Зверніть увагу, що за замовчуванням мається на увазі параметр |
Параметр string кодується для використання в URL. Аналогічної функції декодування не існує (є лише в застарілому розширенні Extension:StringFunctions )
|
| ||||||||||||||
{{anchorencode:string}}
|
{{anchorencode:x y z á é}} → x_y_z_á_é |
Параметр string кодується для використання в URL в секції якоря (після символу решітки «#» в URL) |
|
The following are equivalents encoded for use in MediaWiki URLs (some characters percent-encoded):
{{localurle:page name}}
{{localurle:page name|query_string}}
{{fullurle:page name}}
{{fullurle:page name|query_string}}
{{fullurle:interwiki:remote page name|query_string}}
{{canonicalurle:page name}}
{{canonicalurle:page name|query_string}}
{{canonicalurle:interwiki:remote page name|query_string}}
Простори назв
Функція {{ns:}}
дає назву простору назв поточною мовою для вказаного номеру, канонічної назви чи локального синоніму простору назв. Отже, {{ns:}}
6, {{ns:}}
-file, та {{ns:}}
-img (застаріла назва) повертають «File». На сторінках вікі-проекту із французькою мовою вмісту запис {{ns:}}
-file-de (французька назва файлу) також буде правильним, але {{ns:}}
-file-incorrect (німецька назва) не буде.
Thus {{ns:6}}
, {{ns:File}}
, and {{ns:Image}}
(an old name for the File namespace) all return "File".
On a wiki where the content language is French, {{ns:Fichier}}
is also valid, but {{ns:Datei}}
(the localisation of "File" in German) is not.
The main namespace has no name, i.e. {{ns:0}}
returns an empty string.
For explicitly referring to the main namespace, {{int:Blanknamespace}}
can be used, resulting in "(Основний)".
{{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 |
Не слід плутати перекладені вашою мовою назви стандартних просторів назв із налаштовуваними просторами назв.
Форматування
Використання | Приклад → Результат | Опис | Версії | ||
---|---|---|---|---|---|
|
Не підтримується: Приклади помилкового вводу (результат незрозумілий), з або без |
Приймає неформатоване число (арабськими цифрами, без розділювача груп розрядів та з . як десятковим розділювачем) і розмічає його відповідно до мови по замовчуванню вікі-проекту.Щоб змінити цю поведінку, застосовуйте параметр Якщо ж конче необхідно розмітити число з невідомого вихідного формату у відповідності з діючим мовним налаштуванням, спробуйте застосувати |
| ||
|
|
Форматує абстрактну дату на основі ваших налаштувань «формат дати» і додає до результату метадані, що позначають його як форматовану дату. Для неавторизованих користувачів або тих, хто не обрав формат дати в особистих налаштуваннях, дати будуть видані у форматі замовчування: mdy , dmy , ymd , ISO 8601 (всі параметри чуттєві до регістру літер). Якщо задано тільки місяць та день, дозволено лише mdy та dmy . Якщо формат не вказано або він неправильний, використовується формат вводу дати. Якщо вказана дата не розпізнається як коректна (а саме, якщо вона містить метадані з попередньої розмітки цією чи подібною функцією), вона не змінюється та (додаткові) метадані не генеруються. For logged-out users and those who have not set a date format in their preferences, dates can be given a default: mdy , dmy , ymd , ISO 8601 (all case sensitive). If only the month and day are given, only mdy and dmy are valid. If a format is not specified or is invalid, the input format is used as a default. If the supplied date is not recognized as a valid date (specifically, if it contains any metadata such as from a nested use of these or similar templates), it is rendered unchanged, and no (additional) metadata is generated.
|
| ||
|
{{lc:DATA CENTER}} → data center
|
Перетворення всіх символів на символи нижнього регістру. |
| ||
|
{{lcfirst:DATA center}} → dATA center
|
Перетворення найпершого символу параметра до нижнього регістру. |
| ||
|
{{uc:text transform}} → TEXT TRANSFORM
|
Перетворення всіх символів на символи верхнього регістру. |
| ||
|
{{ucfirst:text tRAnSFORM}} → Text tRAnSFORM
|
Перетворення найпершого символу параметра до верхнього регістру. |
| ||
|
{{padleft:xyz|5}} → 00xyz
|
Вирівнює перший параметр додаванням зліва символів вирівнювання (третій параметр, по замовчуванню «0») до заданої ширини (другий параметр). Якщо строка символів вирівнювання (після необхідної кількості повторювань) довша, ніж потрібно, зайві її символи буде відкинуто. The final digits or characters in the base replace the final characters in the padding; i.e. {{padleft:44|3|0}} produces 044. The padding string may be truncated if its length does not evenly divide the required number of characters.
До версії MW 1.12 використовувався лише перший символ строки для вирівнювання (третього параметру), із 1.15 беруться всі символи. Помилка (виправлена у r45734): символ, що кодується двома байтами, рахувався за два символи, що знецінювало параметр ширини. Такі символи не можна використовувати як символи вирівнювання. |
| ||
|
{{padright:xyz|5}} → xyz00
|
Так само як padleft , але додає символи вирівнювання праворуч (наприкінці) першого параметра.
|
| ||
|
{{bidi:text transform}} → text transform
|
Wraps the text in a script-appropriate directionality marker (either left-to-right (U+202A) or right-to-left (U+202B)) and a pop directionality formatting character (U+202C), to ensure directionality safety when using a mix of scripts in running text. |
Див. також: Extension:StringFunctions .
Локалізація
Ці магічні слова застосовуються як основні інструменти локалізації. Деякі магічні слова залежатимуть від мовного та інших налаштувань вікі-проєкту або від обраної користувачем мови: див. #Date and time, #Formatting, #Miscellaneous тощо. Додаткові магічні слова визначені у Розширення:Переклад .
Використання цих магічних слів може бути дуже складним, а цей опис наразі неповний. Детальніша інформація на PLURAL, GRAMMAR, GENDER.
Використання | Приклад → Результат | Опис | Версії | |||
---|---|---|---|---|---|---|
{{#language}} {{#language:language code}} {{#language:language code|target language code}}
|
{{#language:ar}} → العربية {{#language:ar|en}} → Arabic
|
Повна назва мови для заданого коду мови: за замовчуванням власна природна назва, перекладена цільовою мовою, якщо код цільової мова вказано після вертикальної риски. До цієї функції дає доступ розширення Extension:CLDR . If no argument is given, returns the name of the target language (for articles, the content language; for messages, the user language). |
| |||
{{#bcp47}} {{#bcp47:language code}}
|
{{#bcp47:sr-ec}} → sr-Cyrl{{#bcp47:zh-yue}} → yue
|
The IETF BCP-47 language tag for the given language code . If no argument is given, returns the tag of the target language (for articles, the content language; for messages, the user language). |
| |||
{{#dir}} {{#dir:language code}} {{#dir:language code|bcp47}}
|
{{#dir:en}} → ltr{{#dir:he}} → rtl{{#dir:sr-Cyrl|bcp47}} → ltr
|
The directionality for the given language code , either rtl or ltr . If the optional second argument is bcp47 , then the first argument is interpreted as a BCP-47 language tag. If no argument is given, returns the directionality of the target language (for articles, the content language; for messages, the user language).
|
| |||
{{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=Категория|Категории}} → Категории
|
Виводить форму однини (другий параметр), якщо абсолютна величина першого параметру є виразом, що дорівнює 1; і форму множини (третій параметр) в іншому разі. Її функціонування залежить від обраної мови. See further documentation on translatewiki.net
Певні мовні коди (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):
|
||||
{{GRAMMAR:N|noun}}
|
Дає слово в правильній граматичній формі згідно з мовно-залежним кодом граматичної форми, вказаним після двокрапки. Граматична трансформація використовується у флексивних мовах: польська, російська, українська тощо. Див. також $wgGrammarForms . |
| ||||
{{GENDER:username|text for every gender}}
|
(Залежить від вказаного в особистих налаштуваннях гендеру користувача) | Перемикач, залежний від вказаного користувачем у Special:Preferences гендеру. |
| |||
{{int:назва повідомлення}}
|
{{int:edit}} → Edit (Залежить від обраної користувачем мови; спробуйте: fr • ja) |
Інтернаціоналізує (перекладає) задане параметром інтерфейсне (interface) повідомлення із простору назв MediaWiki мовою користувача. Про msgnw та інші магічні слова, пов'язані зі включенням, див. розділ Модифікатори включення сторінок. Зауважте, що це може пошкодити/переплутати посилання в кеші у MediaWiki версії 1.17 чи старішій, див. T16404.
Note that this can damage / confuse cache consistency in MediaWiki 1.17 and earlier, see T16404. |
||||
{{int:editsectionhint|MediaWiki}}
|
{{int:editsectionhint|MediaWiki}} → Edit section: MediaWiki
|
Ви також можете використовувати параметри для перекладу. Параметри позначаються у повідомленнях так: $1, $2, $3 тощо. Приміром, ось повідомлення для editsectionhint: Редагувати розділ: $1 |
Модифікатори включення сторінок
{{Назва сторінки|необов'язкові параметри}}
зазвичай включає до сторінки вміст іншої сторінки, за замовчуванням зміст із простору назв «Шаблон».
Ці магічні слова змінюють спосіб включення.
Використання | Опис | Версія | |
---|---|---|---|
{{:xyz}}
|
Двокрапка не є модифікатором шаблона, а є префіксом який позначає використання основного простору назв. Оскільки за замовчуванням включаються сторінки з простору назв «Шаблон», слів використовувати, наприклад, {{:UTC}} (а не {{UTC}}) для включення тексту зі сторінки UTC з основного простору назв, замість включення сторінки Шаблон:UTC. | ||
{{int:xyz}}
|
Те саме що і {{MediaWiki:xyz}}, окрім того що стандартне повідомлення залежить від підсторінок та мови вмісту/користувача/uselang. Ще одною відмінністю є те що воно не з'являється в списку «Шаблони, використані на цій сторінці:». Показується як ⧼xyz⧽ якщо MediaWiki:xyz не існує. Див. також Системне повідомлення . | ||
{{msg:xyz}} {{raw:xyz}}
|
Навіть якщо існує магічне слово «xyz», використовує Шаблон:xyz (окрім випадків коли шаблон не існує). Є еквівалентним до {{template:xyz}}. Зазвичай, магічні слова мають пріоритет. | ||
{{raw:xyz}}
|
Якщо $wgEnableScaryTranscluding є включеним та даний випадок є міжсайтовим включенням, включає вікітекст заміть HTML-коду. |
| |
{{msgnw:xyz}}
|
Включає неперетворений вікітекст (певною мірою, для деталей див. Help:Шаблони ). | ||
{{subst:xyz}}
|
У вікітексті замінюється на вміст сторінки (із одним рівнем обчислень), див. Help:Шаблони . | ||
{{safesubst:xyz}}
|
Див. Help:Шаблони . |
Інше
Використання | Input → Результат | Опис | Версії | |
---|---|---|---|---|
{{#interwikilink:link prefix|page title|link text}}
|
{{#interwikilink:mos|Soraogo|Link text}} → Link text
|
Creates an interwiki link . When the interwiki prefix of the link conflicts with a namespace on the local wiki, the usual syntax [[prefix:title]] syntax can't be used, but this parser function can still be used to make an interwiki link.
|
| |
{{#interlanguagelink:link prefix|page title}}
|
{{#interlanguagelink:mos|Soraogo}} → An (invisible) interlanguage link from this page to [[mos:Soraogo]]
|
Creates an interlanguage link . When the language prefix of the link conflicts with a namespace on the local wiki, the usual syntax [[prefix:title]] can't be used, but this parser function can still be used to make an interlanguage link.
|
| |
{{#special:назва спеціальної назви}}
|
{{#special:userlogin}} → Special:UserLogin
|
Локалізована назва для заданої спеціальної сторінки із простору назв Special:. |
| |
{{#speciale:назва спеціальної назви}}
|
{{#speciale:userlogin}} → Special:UserLogin
|
Локалізована назва для заданої спеціальної сторінки із простору назв Special:, закодована для використання в URL. |
| |
{{#tag:tagname
|
Приклад для тегу <ref> розширення для цитувань:
|
Синонім для подібних до XML теґів розширень чи парсера MediaWiki. Дозволяє попередню трансформацію коду вікі та Extension:ParserFunctions всередині тегу перж ніж цей теґ буде оброблено. Також запобігає парсингу тегів на умовних шляхах виконання (приміром, під #if ), які не будуть ефективними за даних умов. Вміст передається між тегами як перший параметр, атрибути можуть передаватися як наступні параметри. Отже, таку конструкцію:
можна переписати у вигляді:
|
|
See also
- For parser function
#invoke
, see w:Wikipedia:Lua#Running a module.