Зверніть увагу! Коли Ви редагуєте цю сторінку, то погоджуєтесь робити свій внесок під ліцензією CC0. Детальніше про умови ліцензії можна дізнатися на сторінці довідки.
Магічними словами (magic words) називають певні комбінації символів, яким MediaWiki зіставляє певне значення чи функцію — поточний час, назву поточної сторінки, поточного сайту тощо. Ця стаття пояснює лише стандартні магічні слова; Дізнатися детальніше — див. Посібник: Магічні слова.
Розрізнюють три загальні типи магічних слів:
Перемикачі поведінки (behavior switches): зазвичай складені з літер верхнього регістру та двох символів підкреслення по боках, як-от__FOO__..
Змінні: слова в подвійних фігурних дужках, складені з літер верхнього регістру, як-от{{FOO}}. Виглядають як виклик шаблона.
Змінні та функції парсера здатні використовувати підстановку subst:, подібно до шаблонів. Магічні слова, призначені для роботи зі сторінкою, змінюють чи повертають дані про поточну сторінку (якщо в параметрах явно не вказано інше), навіть коли вони включені з шаблону чи системного повідомлення.
Перемикачі поведінки
Перемикачі поведінки управляють виглядом чи поведінкою сторінки вікі (якщо це підтримується темою) і часто використовуються для включення певних блоків інформації до її тексту. Деякі з цих перемикачів поведінки не підтримуються темою «Minerva».
Примусово показує зміст на його звичайній позиції (перед першим заголовком, відміняє дію перемикача__NOTOC__).
__TOC__
Показує зміст в місці розташування цього слова (має пріоритет над __NOTOC__). Ефект має тільки однократне використання, повтори на тій самій сторінці ігноруються.
Редагування
__NOEDITSECTION__
Приховує посилання для редагування розділу, що зазвичай стоїть біля його заголовка. Особливо корисне, коли заголовок включено із шаблону. В такому випадку звичайне редагування розділу змінюватиме код шаблону, це — що зазвичай не те, що має намір користувач. Використання цього виразу всередині шаблону, поширить дію виразу і на сам шаблон, сторінки до яких він включений і на всі інші шаблони включені до цієї сторінки. Інший спосіб див. тут.
__NEWSECTIONLINK__
Поруч із вкладкою «Редагувати» додає вкладку для створення нового розділу на звичайних сторінках (подібно до сторінок обговорення), див. Додавання розділу наприкінці статті.
≥ 1.7
__NONEWSECTIONLINK__
Видаляє посилання поруч зі вкладкою «Редагувати» на сторінках просторів назв обговорень.
На сторінці категорії замінює ескізи зображень звичайними текстовими посиланнями.
≥ 1.7
__HIDDENCAT__
На сторінці категорії: приховує цю категорію від внесення у покажчик категорій батьківських категорій та категоризованих сторінок (користувач може це заборонити за допомогою власних налаштувань).
Забороняє будь-які мовні перетворення вмісту для мовних варіантів на сторінці, для тих вікіпроєктів, які мають мовні варіанти сторінок. Так, приміром, буде використана основна мова китайська (zh) замість її варіантів zh_cn, zh_tw, zh_sg, zh_hk тощо.
__NOTITLECONVERT__ __NOTC__
Забороняє мовні перетворення лише назв сторінок для тих вікіпроєктів, які мають мовні варіанти сторінок.
Інше
__START__
Наразі, не діє. Використовувався для вказання початку повідомлення бази даних після коментарю, який не повинен був бути включеним. Видалено в r1695 та повністю видалено в r24784.
Забороняє пошуковим системам індексувати сторінку (сторінка не може виринути в результатах пошуку цих систем). Підкоряється налаштуванню $wgExemptFromUserRobotsControl.
На сторінках перенаправлення: не дозволяє MediaWiki автоматично оновити посилання у випадку, коли дописувач переносить сторінку і вмикає прапорець «Виправити всі перенаправлення на попередню назву» (що потребує $wgFixDoubleRedirects).
Відключає використання глобальної сторінки користувача. Якщо присутнє на центральній сторінці користувача, то відключить відображення цієї сторінки на інших вікі, де не створена сторінка користувача. Також визначає чи мають бути посилання на сторінки користувача на інших вікі синіми або червоними.
Певним сторінкам, як-от сторінки обговорення чи підсторінки шаблонів, не потрібен елемент Вікіданих. Аби запобігти відображенню такої сторінки у переліку Special:UnconnectedPages, напишіть це магічне слово будь-де на сторінці. Сторінки, які не задовольняють критеріям значущості Вікіданих, не мають отримувати елементу Вікіданих.
≥ 1.37.0-wmf.14
Змінні
Змінні надають інформацію про поточну сторінку, вікі, дату тощо. Їх використання синтаксично подібне до шаблонів. Використання змінних із позначкою «[Витратна]» контролюється рушієм MediaWiki, і кількість таких використань на одній сторінці може бути обмеженою.
Якщо назва шаблону збігається із назвою змінної, пріоритет має змінна. Для розгортання, приміром, такого шаблону Template:PAGENAME вам доведеться написати {{Template:PAGENAME}}. Але в деяких випадках вказаний параметр примусить парсер підключити шаблон; приміром, {{CURRENTDAYNAME|x}} звертається до Template:CURRENTDAYNAME, не до однойменної змінної.
Дата і час
Наступні змінні дають поточну дату і час за Гринвічем (UTC).
Внаслідок кешування MediaWiki і веб-оглядача, ці змінні дають час останнього кешування сторінки замість поточного.
Використання цих змінних призводить до кешування сторінок протягом більш обмеженої кількості секунд. Це налаштовано в MagicWordFactory.
Формат отриманих дати й часу залежить від мови вмісту вікіпроєкту. Починаючи з MW 1.19, цей формат визначається мовою сторінки.
День місяця (число, при необхідності доповнене нулем)
≥ 1.6
{{CURRENTDOW}}
5
День тижня (число), від 0 (неділя) до 6 (субота)
{{CURRENTDAYNAME}}
п'ятниця
День тижня (назва)
Час
{{CURRENTTIME}}
18:24
Час (24-годинний формат HH:mm)
{{CURRENTHOUR}}
18
Час (24-годинний формат, число, при необхідності доповнене нулем)
Інше
{{CURRENTWEEK}}
20
Тиждень (число)
{{CURRENTTIMESTAMP}}
20220520182411
Часова мітка YYYYMMDDHHmmss (відповідно до стандарту ISO 8601)
≥ 1.7
Магічного слова {{CURRENTDATE}} немає, але може існувати такий шаблон.
Наступні змінні мають той самий сенс, що й вищезгадані, але використовують налаштування сервера чи $wgLocaltimezone, незалежно від особистих налаштувань користувача.
{{LOCALYEAR}}
{{LOCALMONTH}}
{{LOCALMONTH1}}
{{LOCALMONTHNAME}}
{{LOCALMONTHNAMEGEN}}
{{LOCALMONTHABBREV}}
{{LOCALDAY}}
{{LOCALDAY2}}
{{LOCALDOW}}
{{LOCALDAYNAME}}
{{LOCALTIME}}
{{LOCALHOUR}}
{{LOCALWEEK}}
{{LOCALTIMESTAMP}}
Для ретельнішого форматування часу, або для виведення поточного року та тижня з кращим дотриманням ISO-8601, ви можете забажати встановити Extension:ParserFunctions для використання функції парсера #time.
Піддомен та доменне ім'я (починаючи з MW 1.17 не залежить від $wgServerName).
{{DIRMARK}}
{{DIRECTIONMARK}}
Виводить символ Юнікоду для напрямку запису тексту, що відповідає напрямку стандартного тексту для цього вікіпроєкту (‎ зліва направо, ‏ справа наліво). Корисно в текстах зі змінним напрямком запису. Починаючи з версії 1.19, залежить від мови сторінки.
<translate><!--T:1--> Translated unit. Language: <tvarname=lang>{{TRANSLATIONLANGUAGE}}</tvar>.</translate>
<translate><!--T:2--> Untranslated unit. Language: <tvarname=lang>{{TRANSLATIONLANGUAGE}}</tvar>.</translate>
Translated unit. Language: en.
Not translated unit. Language: en.
Має знаходитися на перекладеній сторінці всередині тегів <translate>. Повертає код мови поточного фрагменту перекладу. На сторінці перекладу, якщо цей фрагмент перекладено, повертає мову перекладу. В іншому разі повертає вихідну мову. Код мови, що повертає цей вираз, може бути перетворений на назву мови за допомогою {{#language:...}}. Має використовуватися лише адміністраторами перекладу.
Повертає необхідний рівень дозволів (наприклад «autoconfirmed», «sysop») для заданої дії (Edit, Move тощо) на поточній сторінці, або порожній рядок для незахищеної сторінки.
Повертає час закінчення обмеження на виконання вказаної дії (наприклад «редагувати», «перейменувати») для поточної сторінки (наприклад «20160418155030», «infinity»). Повертає «infinity», якщо на сторінку не накладено обмежень.
[Ресурсомістка] Повертає перелік джерел каскадного захисту, активних для поточної сторінки. Цей перелік не вміщуватиме назву поточної сторінки, якщо та не містить команд включення до свого тексту власних частин.
Унікальний ідентифікатор зміни. Порожнє в попередньому перегляді, тому можна показати повідомлення про помилку тільки в попередньому перегляді. Може бути відключено в miser mode.
≥ 1.5
{{REVISIONDAY}}
16
День, коли зміна відбулася (число без вирівнювання ширини).
≥ 1.8
{{REVISIONDAY2}}
16
День, коли зміна відбулася (число, при необхідності доповнене нулем).
≥ 1.8
{{REVISIONMONTH}}
05
Місяць, коли зміна відбулася (число; при необхідності доповнене нулем — починаючи з версії 1.17+; без вирівнювання ширини — для старіших версій).
≥ 1.8
{{REVISIONMONTH1}}
5
Місяць, коли зміна відбулася (число без вирівнювання ширини).
Дозволяє модифікувати відображуваний заголовок вищого рівня. Назва має бути еквівалентною назві сторінки: дозволяються тільки зміни в регістрі літер в деяких частинах назви (не в усіх) та взаємозамінювання пробілів з підкресленнями (налаштовується за допомогою $wgRestrictDisplayTitle). Може бути вимкнено параметром $wgAllowDisplayTitle; за замовчуванням увімкнено починаючи з MW 1.10.
Може приймати другий аргумент noerror (сховати повідомлення про помилку при повторному використанні цієї змінної на сторінці) або noreplace (проігнорувати цю змінну, якщо вона використана вище на цій сторінці).
Використовується для категоризації сторінок, встановлює за замовчуванням ключ сортування категорії. Якщо, приміром, записати {{DEFAULTSORT:Smith, John}} наприкінці сторінки John Smith, то за замовчуванням сторінка в категоріях класифікуватиметься під літерою «S». Може приймати другий аргумент noerror або noreplace, щоб запобігти відображенню помилки, якщо на сторінці вказано кілька ключів для сортування, чи відповідно змусити defaultsort не справляти ефекту, якщо defaultsort визначено на сторінці раніше.
Числа, повернуті цими змінними, зазвичай містять символи розділення десяткових розрядів (кома, крапка, пробіл залежно від мови локалізації), але використання прапорця «:R» дасть неформатоване число (приміром, {{NUMBEROFPAGES}} → 1 284 039, але {{NUMBEROFPAGES:R}} → 1284039).
Використовуйте «|R» для магічних слів, яким потрібен параметр, подібних до PAGESINCATEGORY (приміром, {{PAGESINCATEGORY:Help}} та {{PAGESINCATEGORY:Help|R}}, або {{PAGESINCATEGORY:Help|subcats}} та {{PAGESINCATEGORY:Help|subcats|R}}). Те ж саме стосується {{PAGESIZE:назва сторінки}}, див. нижче.
Числові значення змінних форматуються залежно від мовних налаштувань вікі-проєкту. Починаючи з версії MW 1.19, вони залежать від мови сторінки.
[Ресурсомістка] Кількість сторінок (з підкатегоріями та файлами включно) в заданій категоріїcategoryname. (Category:Help використовується в якості прикладу)
[Ресурсомістка] Кількість сторінок в заданому просторі назв (замініть index відповідним номером простору назв). Приміром, {{PAGESINNAMESPACE:14}} дасть кількість сторінок категорій. {{PAGESINNS:0}} відрізняється від {{NUMBEROFARTICLES}} тим, що перша включає сторінки перенаправлень і розв'язання синтаксичних неоднозначностей. Вимкнено за замовчуванням, можна включити у $wgAllowSlowParserFunctions.
≥ 1.7
Назви сторінок
Змінна
Для цієї сторінки
Опис
Версії
{{FULLPAGENAME}}
Help:Magic words/uk
Простір назв та повна назва сторінки (включно із усіма рівнями підсторінки).
≥ 1.6
{{PAGENAME}}
Magic words/uk
Повна назва сторінки (включно із усіма рівнями підсторінки) без простору назв.
{{BASEPAGENAME}}
Magic words
Назва сторінки без назви поточної підсторінки subpage без простору назв. Поверне Title/Foo на сторінці Help:Title/Foo/Bar.
≥ 1.7
{{ROOTPAGENAME}}
Magic words
Назва кореню поточної сторінки. Поверне Title для сторінки Help:Title/Foo/Bar.
≥ 1.22
{{SUBPAGENAME}}
uk
Назва поточної підсторінки. Поверне Bar на сторінці Help:Title/Foo/Bar.
Якщо немає підсторінки, повертається значення {{PAGENAME}}.
На сторінці обговорення: повна назва основної сторінки, пов'язаної з цією сторінкою обговорення.
≥ 1.7
{{TALKPAGENAME}}
Help talk:Magic words/uk
Повна назва сторінки обговорення для поточної сторінки.
≥ 1.7
На жодну з них не впливають зміни відображуваної назви, здійснені за допомогою {{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.
На сторінці обговорення: назва простору назв пов'язаної основної сторінки
≥ 1.7
{{TALKSPACE}}
Help talk
Назва простору назв для сторінки обговорення поточної сторінки
≥ 1.7
Нижче наведено перелік еквівалентних змінних, які дають результат, придатний для кодування 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; документація на відповідних сторінках довідки (Довідка:Розширення:ParserFunctions).
[Ресурсомістка] Повертає необхідний рівень доступу (наприклад «autoconfirmed», «sysop») для заданої дії (Edit, Move тощо) на вказаній сторінці, або порожній рядок для незахищеної сторінки.
[Ресурсомістка] Виводить закінчення терміну захисту (наприклад, «20160418155030», «infinity») від даної дії (наприклад, «редагування», «перейменування») на конкретній сторінці. Повертає «infinity», якщо незахищена.
[Ресурсомістка] Повертає перелік джерел каскадного захисту, активних на вказаній сторінці. Цей перелік не вміщуватиме назву вказаної сторінки, якщо та не містить команд включення власних частин.
[Ресурсомістка] Дає місяць останньої зміни вказаної сторінки* (число, при необхідності доповнене нулем, починаючи з версії 1.17+; число без вирівнювання для старіших версій).
* Якщо вказаний параметр збігається з назвою поточної сторінки, функції парсера даватимуть інформацію про попередню версію сторінки в разі попереднього перегляду та підстановки (порожні строки при створенні сторінки). При звичайному перегляді (включно з переглядом минулих версій) функції даватимуть інформацію про поточну сторінку і можуть не вважатися витратними.
Веб посилання на сторінку без уточнення протоколу, яке залежить від $wgServer конфігурації для локальної вікі (і таким чином можуть або починатися із префіксу http(s)://, або бути без префікса). Дозволено префікси інтервікі. Примітка: якщо таке посилання не взяте у квадратні дужки, воно не буде автоматично зроблено активним.
{{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)
Функція {{ns:}} дає назву простору назв поточною мовою для вказаного номеру, канонічної назви чи локального синоніму простору назв. Отже, {{ns:6}}, {{ns:File}}, та {{ns:Image}} (застаріла назва) повертають «File». На сторінках вікі-проекту із французькою мовою вмісту запис {{ns:Fichier}} (французька назва файлу) також буде правильним, але {{ns:Datei}} (німецька назва) не буде.
{{nse:}} — еквівалентна функція, але її результат кодований для використання в URL MediaWiki. Вона замінює пробіли підкресленнями.
Не підтримується: {{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: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 8601 вимагає дату за Григоріанським календарем, ця функція з параметром ISO розмічатиме також дати, що виходять за його звичайні межі (до 1583 року). Також ця функція нездатна правильно перетворювати негативні роки (з ISO 8601) та роки до Різдва Христова (BC чи BCE).
{{padleft:xyz|5|_}} → __xyz {{padleft:xyz|5|abc}} → abxyz {{padleft:xyz|2}} → xyz {{padleft:|1|xyz}} → x
(перший символ параметра)
Вирівнює перший параметр додаванням зліва символів вирівнювання (третій параметр, по замовчуванню «0») до заданої ширини (другий параметр). Якщо строка символів вирівнювання (після необхідної кількості повторювань) довша, ніж потрібно, зайві її символи буде відкинуто.
До версії MW 1.12 використовувався лише перший символ строки для вирівнювання (третього параметру), із 1.15 беруться всі символи.
Помилка (виправлена у r45734): символ, що кодується двома байтами, рахувався за два символи, що знецінювало параметр ширини. Такі символи не можна використовувати як символи вирівнювання.
Ці магічні слова застосовуються як основні інструменти локалізації. Деякі магічні слова залежатимуть від мовного та інших налаштувань вікі-проєкту або від обраної користувачем мови: див. #Date and time, #Formatting, #Miscellaneous тощо. Додаткові магічні слова визначені у Розширення:Переклад.
Використання цих магічних слів може бути дуже складним, а цей опис наразі неповний. Детальніша інформація на 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=Категория|Категории}} → Категории
Виводить форму однини (другий параметр), якщо абсолютна величина першого параметру є виразом, що дорівнює 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):
Дає слово в правильній граматичній формі згідно з мовно-залежним кодом граматичної форми, вказаним після двокрапки. Граматична трансформація використовується у флексивних мовах: польська, російська, українська тощо. Див. також $wgGrammarForms.
≥ 1.7
{{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).
Крапка (.) замість імені користувача визначає гендер користувача по замовчуванню, налаштований у вікі-проєкті.
Інтернаціоналізує (перекладає) задане параметром інтерфейсне (interface) повідомлення із простору назв MediaWiki мовою користувача. Про msgnw та інші магічні слова, пов'язані зі включенням, див. розділ Модифікатори включення сторінок. Зауважте, що це може пошкодити/переплутати посилання в кеші у MediaWiki версії 1.17 чи старішій, див. T16404.
Ви також можете використовувати параметри для перекладу.
Параметри позначаються у повідомленнях так: $1, $2, $3 тощо. Приміром, ось повідомлення для editsectionhint: Редагувати розділ: $1
В цьому прикладі MediaWiki замінить $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-коду.
{{#language:language code}} {{#language:language code|target language code}}
{{#language:ar}} → العربية {{#language:ar|en}} → Arabic
Повна назва мови для заданого коду мови: за замовчуванням власна природна назва, перекладена цільовою мовою, якщо код цільової мова вказано після вертикальної риски. До цієї функції дає доступ розширення Extension:CLDR.
{{#tag:ref|Citation on Magic words/uk. |name = "multiple"}}
→
[1]
Синонім для подібних до XML теґів розширень чи парсера MediaWiki. Дозволяє попередню трансформацію коду вікі та Extension:ParserFunctions всередині тегу перж ніж цей теґ буде оброблено. Також запобігає парсингу тегів на умовних шляхах виконання (приміром, під #if), які не будуть ефективними за даних умов. Вміст передається між тегами як перший параметр, атрибути можуть передаватися як наступні параметри. Отже, таку конструкцію:
Для того, щоб передати порожній вміст, слід записувати {{#tag:tagname||attribute1=value1|attribute2=value2}}. Пробіли на початку і в кінці області між вертикальними рисками ||, зарезервованій для вмісту, не дозволено.
Увага: