Help:Magic words/uk

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

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


 * Перемикачі поведінки (behavior switches): зазвичай складені з літер верхнього регістру та двох символів підкреслення по боках, як-от  ..


 * Змінні: слова в подвійних фігурних дужках, складені з літер верхнього регістру, як-от  . Виглядають як виклик шаблона.


 * Функції парсера (аналізатора вікітекста): можуть отримувати параметри і мають вигляд такий   або ж такий  , наприклад . Див. також  та.

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

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

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

Якщо назва шаблону збігається із назвою змінної, пріоритет має змінна. Для розгортання, приміром, такого шаблону    :PAGENAME вам доведеться написати. Але в деяких випадках вказаний параметр примусить парсер підключити шаблон; приміром,  звертається до     :CURRENTDAYNAME, не до однойменної змінної.

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

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

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

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



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

Технічні метадані
Примітка: Значення змінних, що стосуються версії сторінки, завжди пов'язані з останнім редагуванням сторінки, навіть якщо ви переглядаєте старішу її версію.

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

Використовуйте "|R" для магічних слів, яким потрібен параметр, подібних до PAGESINCATEGORY (приміром,  та , або   та  ). Те ж саме стосується, див. нижче.

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

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

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

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

{{Warning|1=Назви сторінок, що містять певні символи, такі як апостроф  чи зірочка , можуть при роботі з цими змінними продукувати неочікувані результати, такі як. Див. повідомлення про помилки T16779, T18474, T37628, T37746. Простим способом запобігти цьому є екранування назви сторінки функцією парсера  (Help:Extension:ParserFunctions).

Приміром, для сторінки з назвою "$pagename" наступний код відобразить повідомлення "$result":

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



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

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



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

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

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

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

Простори назв
Функція  дає назву простору назв поточною мовою для вказаного номеру, канонічної назви чи локального синоніму простору назв. Отже,,  , та   (застаріла назва) повертають "    ". На сторінках вікі-проекту із французською мовою вмісту запис  (французська назва файлу) також буде правильним, але   (німецька назва) не буде.

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

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

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

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

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

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