Help:Magic words/uk

Магічними словами (magic words) називають певні комбінації символів, яким MediaWiki зіставляє певне значення чи функцію — поточний час, назву поточної сторінки, поточного сайту тощо. Ця стаття пояснює лише стандартні магічні слова; Дізнатися детальніше — див. .

Розрізнюють три загальні типи магічних слів:


 * Перемикачі поведінки (behavior switches): зазвичай складені з літер верхнього регістру та двох символів підкреслення по боках, як-от  ..
 * Змінні: слова в подвійних фігурних дужках, складені з літер верхнього регістру, як-от  . Виглядають як виклик шаблона.
 * Функції парсера (аналізатора вікітекста): можуть отримувати параметри і мають вигляд такий   або ж такий  , наприклад . Див. також та.

Змінні та функції парсера здатні використовувати підстановку subst:, подібно до шаблонів. Магічні слова, призначені для роботи зі сторінкою, змінюють чи повертають дані про поточну сторінку (якщо в параметрах явно не вказано інше), навіть коли вони включені з шаблону чи системного повідомлення.



Перемикачі поведінки
Перемикачі поведінки управляють виглядом чи поведінкою сторінки вікі (якщо це підтримується темою) і часто використовуються для включення певних блоків інформації до її тексту. Деякі з цих перемикачів поведінки не підтримуються темою «Minerva».

Змінні
Змінні надають інформацію про поточну сторінку, вікі, дату тощо. Їх використання синтаксично подібне до шаблонів. Використання змінних із позначкою « [Витратна] » контролюється рушієм MediaWiki, і кількість таких використань на одній сторінці може бути обмеженою.

Якщо назва шаблону збігається із назвою змінної, пріоритет має змінна. Для розгортання, приміром, такого шаблону вам доведеться написати. Але в деяких випадках вказаний параметр примусить парсер підключити шаблон; приміром, $tpl-currentdayname-code звертається до $tpl-currentdayname-result, не до однойменної змінної.



Дата і час
Наступні змінні дають поточну дату і час за Гринвічем (UTC).

Внаслідок кешування MediaWiki і веб-оглядача, ці змінні дають час останнього кешування сторінки замість поточного.

Використання цих змінних призводить до кешування сторінок протягом більш обмеженої кількості секунд. Це налаштовано в MagicWordFactory.

Формат отриманих дати й часу залежить від мови вмісту вікіпроєкту. Починаючи з MW, цей формат визначається мовою сторінки.

Наступні змінні мають той самий сенс, що й вищезгадані, але використовують налаштування сервера чи, незалежно від особистих налаштувань користувача.



Для ретельнішого форматування часу, або для виведення поточного року та тижня з кращим дотриманням ISO-8601, ви можете забажати встановити для використання функції парсера .



Статистика
Числа, повернуті цими змінними, зазвичай містять символи розділення десяткових розрядів (кома, крапка, пробіл залежно від мови локалізації), але використання прапорця «:R» дасть неформатоване число (приміром, $nop-code &rarr; $nop-result, але $nop-r-code &rarr; $nop-r-result).

Використовуйте «|R» для магічних слів, яким потрібен параметр, подібних до PAGESINCATEGORY (приміром, $pic та $pic-r, або $pic-subcats та $pic-subcats-r). Те ж саме стосується $pagesizeназва сторінки$pagesize-end, див. нижче. Also applicable to hereinbefore.

Числові значення змінних форматуються залежно від мовних налаштувань вікі-проєкту. Починаючи з версії MW, вони залежать від мови сторінки.



Назви сторінок
На жодну з них не впливають зміни відображуваної назви, здійснені за допомогою ; Повернені значення є оригінальним заголовком сторінки.

Магічні слова  та   працюють лише в просторах назв, в яких дозволено підсторінки. Про дозвіл підсторінок див. .

Починаючи з версії MW 1.15+, всі ці змінні можуть приймати параметр, яким можна задати назву сторінки, яка (замість поточної) визначить значення змінної:





Кодування назви сторінки в URL
Нижче наведено перелік еквівалентних змінних, які дають результат, придатний для кодування URL, — певні символи, такі як апостроф, знак запитання тощо, замінено їхніми числовими кодами для URL, а пробіли — підкресленням:



Зверніть увагу на те, що,   та   реалізовано різним чином. Детальніше див. .

Простори назв
Нижче наведено перелік еквівалентних змінних, які дають результат, придатний для кодування URL, — певні символи, такі як підкреслення, апостроф, знак запитання тощо, замінено їхніми числовими кодами для URL:



Починаючи з версії 1.15+, ці функції можуть приймати як параметр повну назву сторінки замість поточної:

Цей параметр не повинен бути назвою простору назв:
 * &rarr; 
 * &rarr;  (Pages in main space will return empty)
 * &rarr; 
 * &rarr; 
 * &rarr; 
 * &rarr; 
 * &rarr;   (Empty)

Інше


Функції парсера
Функції парсера (парсеру вікітексту) дуже подібні до змінних, але приймають один чи більше параметрів. З технічної точки зору, будь-яке магічне слово, що приймає аргумент, є функцією парсера. Їхнім назвам інколи передує символ решітки «#», щоб відрізнити їх від звернення до шаблонів.

Ця стаття описує лише функції парсера, які вбудовані в код MediaWiki. Будь-які інші функції парсера можуть бути додані розширеннями MediaWiki (MediaWiki Extentions), такими як ; документація на відповідних сторінках довідки.



Технічні метадані іншої сторінки


Простори назв
Функція  дає назву простору назв поточною мовою для вказаного номеру, канонічної назви чи локального синоніму простору назв. Отже, 6,  -file, та  -img (застаріла назва) повертають «    ». На сторінках вікі-проекту із французькою мовою вмісту запис -file-de (французька назва файлу) також буде правильним, але  -file-incorrect (німецька назва) не буде. Thus,  , and   (an old name for the File namespace) all return "    ". On a wiki where the content language is French,  is also valid, but   (the localisation of "File" in German) is not.

The main namespace has no name, i.e.  returns an empty string. For explicitly referring to the main namespace,  can be used, resulting in "".

— еквівалентна функція, але її результат кодований для використання в URL MediaWiki. Вона замінює пробіли підкресленнями.

Не слід плутати перекладені вашою мовою назви стандартних просторів назв із налаштовуваними просторами назв.

Форматування
'''Див. також:'''.

Локалізація
Ці магічні слова застосовуються як основні інструменти локалізації. Деякі магічні слова залежатимуть від мовного та інших налаштувань вікі-проєкту або від обраної користувачем мови: див. #Date and time, #Formatting, #Miscellaneous тощо. Додаткові магічні слова визначені у.

Використання цих магічних слів може бути дуже складним, а цей опис наразі неповний. Детальніша інформація на PLURAL, GRAMMAR, GENDER.



Модифікатори включення сторінок
зазвичай включає до сторінки вміст іншої сторінки, за замовчуванням зміст із простору назв «Шаблон». Ці магічні слова змінюють спосіб включення.

Інше
For parser function #invoke, see w:Wikipedia:Lua.