Чарівні слова

Інформація про кількість статей виводиться за допомогою чарівних слів

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

Опис[]

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

Чарівні слова можуть бути додані в будь-якому редакторі (як у візуальному, так і в вихідному коді). Проте, щоб змінити чарівне слово, необхідно працювати в вихідному коді. В якості альтернативи в візуальному редакторі можна просто вилучити старе чарівне слово і замість нього додати нове.

Всього існують три види чарівних слів:

Перемикачі поведінки: ними є слова, написані великими літерами і обрамлені подвійним підкресленням (наприклад, __NOTOC__)
Змінні: вони також використовують великі літери, але вони укладені в подвійні фігурні дужки (наприклад, {{SITENAME}}). За своєю будовою вони схожі на шаблони.
Функції парсера: виглядають майже так само, як і змінні, але після відкривающих фігурних дужок йде знак решітки. Крім того, функції парсера можуть приймати параметри (наприклад, {{#invoke:}}).

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

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

Перемикачі поведінки[]

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

__NOTOC__ приховує зміст на сторінкм.
__FORCETOC__ змушує зміст з'явитися в звичайному місці — перед першим заголовком (навіть якщо воно складається з одного розділу). Скасовує дію NOTOC.
__TOC__ поміщає зміст сторінки туди, де знаходиться чарівне слово. Скасовує дію NOTOC.
__NOEDITSECTION__ приховує посилання «правити» для кожної секції сторінки.
__HIDDENCAT__ використовується для категорій і дозволяє приховати її і нижченаведені з більш старших категорій.
__NOWYSIWYG__ відключає візуальний редактор на сторінці; при спробі перейти на нього з'явиться повідомлення, що сторінка містить складний код.

Змінні[]

Змінні повертають відомості про поточну сторінку, вікі-проєкт або датою. Синтаксис більшості з них схожий на синтаксис шаблонів.

Якщо ім'я шаблону збігається зі змінною, то викликається змінна (якщо у вас є шаблон {{CURRENTYEAR}}, то для його виклику доведеться ввести {{Template:CURRENTYEAR}}); саме тому не рекомендується називати шаблони так само, як і змінні.

Нижче наведені деякі чарівні слова з цієї групи:

{{NUMBEROFARTICLES}} — кількість сторінок в основному просторі в рамках вікі.
{{NUMBEROPAGES}} — загальна кількість сторінок на проєкті.
{{SITENAME}} — виводить назву вікі.
{{PAGENAME}} — відображає назву сторінки, на якій було додано дане чарівне слово без вказівки простору імен. Для сторінки «Довідка: Зміст/ru» результатом буде «Зміст/ru».
{{BASEPAGENAME}} — відображає назву сторінки без вказівки простору імен і без попередньої підсторінки. Для сторінки «Довідка:Зміст/ru» результатом буде «Зміст».
{{SUBPAGENAME}} — відображає назву підсторінки. Для сторінки «Довідка:Зміст/ru» результатом буде «ru».
{{FULLPAGENAME}} — відображає назву сторінки з урахуванням простору імен або підлеглих. Для сторінки «Довідка:Зміст/ru» результатом буде «Довідка:Зміст/ru».
{{DISPLAYTITLE:Заголовок}} — змінює верхній заголовок поточний сторінки (зміни видно в назві вкладки).
{{DEFAULTSORT:Ключ}} — встановлює ключ сортування у всіх категоріях, де використовується ця сторінка: якщо для сторінки «Яблуко» використовувати {{DEFAULTSORT:Б}}, то сторінка в категоріях буде знаходитися в розділі на букву «Б».

Функції парсера[]

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

Нижче будуть розглянуті чарівні слова, які надаються в MediaWiki (тут не будуть використовуватися функції парсера з розширення ParserFunctions):

{{PAGESIZE:назва сторінки}} — відображає розмір деякої сторінки. Для отримання числа без форматування потрібно додати в кінці |R. Дане чарівне слово є «витратним» і кількість його включень на одній сторінці обмежено.
{{filepath:Wiki-wordmark.png|розмір|nowiki}} — без додаткових параметрів повертає вказане зображення. При завданні розміру на сторінці буде змінене зображення (його можна тільки зменшити), а якщо ще додати параметр nowiki — посилання буде змінена для отримання зображення заданої ширини (якщо розмір не заданий — то посилання буде для вихідного дозволу файлу).
{{ns:}} — повертає назву просторі імен. Як параметр можна вказати номер простору або його назву.
{{#special:назва спеціальної сторінки}} — відображає на сторінці локалізовану назву деякою спеціальної сторінки.
{{plural:число|is|are}} — виводить форму множинного або однини в залежності від значення першого параметра (однина виводиться тільки для 1 і -1). У українській мові використовуються чотири параметра через ще однієї додаткової форми (в результаті {{PLURAL:3|сторінка|сторінки|сторінок}} виведе «сторінки», а {{PLURAL:5|сторінка|сторінки|сторінок}} — «сторінок»).
{{{#tag:назва тега|зміст|параметр1=значення1|параметр2=значення2|...}} — альтернативний спосіб використання тегів, при якому спочатку обробляється його зміст. Таким чином, при використанні {{#tag:ref|Текст приміток|name="multiple"}} створюється примітка, що містить в собі підпис користувача, а не три тильди.

Специфічні чарівні слова[]

Навігаційне меню[]

Зазначені нижче чарівні слова використовуються при редагуванні навігаційного меню і використовуються для його автоматичного заповнення:

#categoryX# — де X більше 0. У результаті створюється список з топ-8 сторінок з X по рахунку найбільшою категорії на вікі.
#category-X# — додає топ-8 сторінок з Категорія:X.
#visited# — виводить список найбільш відвідуваних сторінок.
#newlychanged# — додає недавно відредаговані статті.
#topusers# — відображає список найбільш активних користувачів на проєкт.

Категорії-галереї[]

Дані чарівні слова застосовуються тільки при включених категоріях-галереях:

__NOCATEGORYGALLERY__ — приховує категорію-галерею на сторінці категорії.
__FORCECATEGORYGALLERY__ — якщо розширення категорії-галереї включено на співтоваристві, але не задіяно на сторінці категорій, то це додасть її туди.

Застосування[]

Область використання чарівних слів дуже велика — вони можуть бути задіяні як для простого зміни оформлення сторінки, так і для побудови досить складних і модулів. Досить часто на головних сторінках можна зустріти інформацію про кількість сторінок, редагувань, активних користувачів і т.д., яка виводиться завдяки чарівним словам.

Розглядаючи найбільш часто використовувані слова, можна відзначити {{PAGENAME}}, яке дозволяє уникнути проблем з оновленням заголовків тексту або шаблонів при перейменуванні сторінки або {{SITENAME}}, які особливо зручно використовувати при довгому і / або складному назві вікі. Крім того, чарівні слова використовуються в системних повідомленнях (особливо багато їх в описах до досягнень).

Цікаві факти[]

У рамках Фандома користувачі не можуть створювати свої власні чарівні слова.
На деяких проєктах використовують чарівне слово {{DEFAULTSORT:*}} для виділення ключових елементів в категорії для того, щоб вони були в самому її початку (наприклад, сторінки альбомів серед безлічі сторінок про саундтреках).
Існує баг з чарівним словом {{NUMBEROFACTIVEUSERS}}: іноді воно видає від'ємне значення −1.