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, такими як ; документація на відповідних сторінках довідки.

Namespaces
returns the current localized name for the namespace with that index, canonical name, or local alias. 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.

is the equivalent encoded for MediaWiki URLs. It does the same, but it replaces spaces with underscores, making it usable in external links.

Don't confuse localised namespaces with custom namespaces.

Formatting
See also:.

Localization
Here are the magic words which are used as main localisation tools. Other magic words will often depend on the wiki's locale and configuration or on the chosen language: see in particular #Date and time, #Formatting, #Miscellaneous. More magic words are added by the.

The usage of these magic words can be very complex, and the documentation is currently incomplete; there's some more info on PLURAL, GRAMMAR, GENDER.