Help:Magic words/uk

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

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


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


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


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

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

Перемикачі поведінки
Перемикачі поведінки управляють виглядом чи поведінкою сторінки вікі і часто використовуються для включення певних блоків інформації до її тексту.

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

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

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

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

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

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

Для різноманітніших варіантів форматування дати й часу вам знадобиться функція #time parser function розширення .

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

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

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

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

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

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

Приміром, для сторінки з назвою "L'Aquila" наступний код відобразить повідомлення "Numeric char encoding":

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



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

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



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

Цей параметр не повинен бути назвою простору імен:
 * &rarr; 
 * &rarr; 
 * &rarr; 
 * &rarr;   (Empty)

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

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

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

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

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

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

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

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