Довідка Чарівні слова - MediaWiki

Зміст

  • 1 Перемикачі поведінки
  • 2 Змінна
    • 2.1 Дата та час
    • 2.2 Технічні метадані
    • 2.3 Статистика
    • 2.4 Назви сторінок
      • 2.4.1 URL-адреси, закодовані іменами сторінок
    • 2.5 Простори імен
    • 2.6 Інше
  • 3 Функції аналізатора
    • 3.1 Технічні метадані іншої сторінки
    • 3.2 Дані URL
    • 3.3 Простори імен
    • 3.4 Форматування
    • 3.5 Локалізація
    • 3.6 Модифікатори перекладача
    • 3.7 Різне

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

слова

Існує три загальних типи магічних слів:

  • Перемикачі поведінки: вони зазвичай пишуться у формі великих літер, замінених подвійними підкресленнями, наприклад.__FOO__ .
  • змінні: це слова з великої літери, оточені подвійними дужками, наприклад.> . Таким чином, вони дуже схожі на деякі формати.
  • Функції аналізатора: вони отримують параметри і мають форму >, бути у формі >, наприклад. >. Див. Також Довідка: Розширення: ParserFunctions та Розширення: Scribunto .

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

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

Змінні повертають інформацію про поточну сторінку, вікі чи дату. Їх синтаксис подібний до форматів. Програмне забезпечення веде облік змінних, позначених як " [Дорого] ”, А кількість таких змінних, які можна включити на сторінку, обмежена.

Якщо ім'я формату конфліктує зі змінною, буде використана змінна (тому для транскрипції формату Шаблон: PAGENAME вам потрібно буде ввести>). У деяких випадках додавання параметрів змусить синтаксичний аналізатор викликати формат; наприклад,> включити шаблон: CURRENTDAYNAME, ні змінна.

Дата і час

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

Через MediaWiki та кешування браузера ці змінні відображаються під час кешування сторінки, а не поточної дати.

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

Чарівні слова з датою та часом відформатовані мовою вмісту wiki. З 1.19 вони залежать від мови вмісту вікі.

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

Щоб отримати більш детальне форматування часу або зробити поточний рік та тиждень більш відповідними ISO-8601, ви можете встановити Extension: ParserFunctions, щоб використовувати функцію партера #time..

Технічні метадані

Змінна Що створює опис версій веб-сайт
> MediaWiki Назва сайту Wiki ($ wgSitename)
> //www.mediawiki.org URL-адреса домену ($ wgServer).
> www.mediawiki.org Імена доменів та субдоменів (більше не залежать від $ wgServerName з версії 1.17).
>

Не перекладена одиниця. Мова:> .

Не перекладена одиниця. Мова: en.

Він може отримати другий аргумент noerror або noreplace придушити повідомлення про помилки при використанні DISPLAYTITLE на одній сторінці кілька разів або змусити цей DISPLAYTITLE нічого не робити, якщо на сторінці вже вказано інше DISPLAYTITLE.

(для noerror та noreplace)

(для noerror та noreplace)

Статистика

Числа, що повертаються цими змінними, зазвичай містять роздільники (коми, крапки або пробіли, залежно від місцевої мови), але можуть повертати необроблені числа із позначкою ": R" (наприклад,> → 1.010.874 та> → 1010874).

Число магічних слів відформатовано мовою вмісту wiki. Починаючи з 1.19, це залежить від мови вмісту сторінки.

Відповідно, кількість

  • всі сторінки
  • звичайні сторінки (крім підкатегорій та файлів)
  • підкатегорії або
  • файлів

Назви сторінок

Заголовок сторінки на безпосередньо вищому рівні підсторінки без простору імен.

Поверне панель на сторінці Довідка: Заголовок/Фу/Бар .

Якщо підсторінка не існує, повертається значення>.

Жодне з них не зазнає змін у назві дисплея за допомогою>; повернені значення - це оригінальний заголовок сторінки.

Чарівні слова> та> працюють лише у просторах імен, у яких увімкнено підсторінки. Інформацію про ввімкнення підсторінок див. У розділі $ wgNamespacesWithSubpages.

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

  • > → Головна сторінка
Увага:Якщо заголовок сторінки містить будь-які частини, які мають "." Або ".", магічне слово не повертає нічого. > → '. Нічого не повертається.
Увага:Назви сторінок, що містять певні символи, такі як апострофи або зірочки *, можуть давати несподівані результати при роботі з цими чарівними словами, наприклад >>>. Див. Помилки T16779, T18474, T37628, T37746. Один простий спосіб виправити це - обернути ім’я сторінки у> з розширення ParserFunctions.

Імена сторінок, закодовані за допомогою URL

Нижче наведено еквіваленти, закодовані для використання в URL-адресах MediaWiki (тобто пробіли, замінені підкресленнями, а деякі символи HTML екрановані за допомогою числового кодування символів):

Зверніть увагу, що>,> та> мають різні реалізації. Детальніше див. У посібнику: Кодування PAGENAMEE.

простори імен

Нижче наведено еквіваленти, закодовані для використання в URL-адресах MediaWiki (пробіли замінено на підкреслення та деякі символи, кодовані у відсотках):

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

  • > → 0
  • > → (Сторінки в основному просторі повернуться порожніми)
  • > → шаблон
  • > → шаблон
  • > → шаблон
  • > → Шаблон розмови

Параметр не повинен бути ім'ям простору імен:

Інший

Функції аналізатора

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

Ця сторінка описує лише функції аналізатора, які є невід’ємними частинами програмного забезпечення MediaWiki. Інші функції аналізатора можуть бути додані розширеннями MediaWiki, такими як Extension: ParserFunctions. Для тих, хто дивиться Довідка: Розширення: ParserFunctions .

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

дії | назва сторінки>>

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

Дані URL

Функція аналізатора Вхід → Вихід Опис Версії
назва сторінки >>
назва сторінки
| QUERY_STRING >>		 >
→/wiki/MediaWiki
>
→ /w/index.php?title=MediaWiki&printable=yes		 Відносний шлях до заголовка.
назва сторінки >>
назва сторінки
| QUERY_STRING >>
interwiki: назва віддаленої сторінки
| QUERY_STRING >>		 >
→ //www.mediawiki.org/wiki/Category:Top_level

Параметр nowiki зазвичай видаляє посилання навколо шляху до файлу (чого не можна побачити в цьому прикладі).

Зверніть увагу, що за замовчуванням змінено з | WIKI на | QUERY у 1.17; це може зламати шаблони, які покладаються на цю функцію.

простори імен

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

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

Простори імен вмісту Обговорення просторів імен Вихід використання Вихід використання
> /> Посередник > /> Спеціальна
(немає говорити сторінка)
> /> > /> Розмовляти
> /> Клієнт > /> Розмова користувача
> /> Проект
Змінюється між вікі 		> /> Розмова про проект
> /> або> Філе > /> або> Файлова розмова
> /> MediaWiki > /> Обговорення на MediaWiki
> /> шаблон > /> Шаблон розмови
> /> Допомога > /> Допоможіть поговорити
> /> Категорія > /> Категорія розмови

Не плутайте локалізовані простори імен зі спеціальними просторами імен.

Форматування

Бере неформатоване число (арабська, без роздільників груп і. Як десятковий роздільник) і видає його в локалізованому розрядному скрипті та відформатоване десятковими та десятковими роздільниками груп, відповідно до стандартної локалі wiki.
Параметр | R може бути використаний для зворотної поведінки для використання в математичних ситуаціях: він надійний і повинен використовуватися лише для деформації чисел, які, як відомо, відформатовані точно так, як formatnum їх форматує з мовою wiki.

Параметр NOSEP ("без роздільників") означає, що жодні роздільники груп/десятків не змінюються; formatnum перетворить лише самі цифри на мови, які не використовують індуїстсько-арабську систему числення. NOSEP також може запобігти нестандартним групуванням цифр, на які ви не очікували.

Увага: Ведучі нулі не видаляються, замість цього ви можете використовувати>, якщо у вас встановлено Extension: ParserFunctions.
Увага: Якщо ви не вводите числа в точному форматі, не очікуйте надійного виводу, особливо на неанглійських вікі.

Якщо вам дійсно потрібно відформатувати (відповідно до локації вікі) число у невідомому форматі вводу, ви можете спробувати використати formatnum двічі (але не, якщо він може мати десяткову групу, або його роздільник буде з’їдено, або число не буде бути відформатованим). Майте на увазі, що це скоріше хакерство, ніж звичайний спосіб продовження, тому результат може бути ненадійним.

>
→ 2009 25 грудня (ваша попередня), 25 грудня 2009 (за замовчуванням)
>
→ 25 грудня 2009 р. (Ваш преф), 25 грудня 2009 р. (За замовчуванням)
>
→ 25 грудня 2009 р. (Ваш преф), 25 грудня 2009 р. (За замовчуванням)
>
→ 2009-12-25 (ваш попередній), 2009-12-25 (за замовчуванням)
>
→ 25 грудня (ваш попередній), 25 грудня (за замовчуванням)

Примітки: У наведеному вище прикладі "ваш преф" стосується вашої переваги дати лише у поточній вікі MediaWiki.