Розширення:Babel

Довідка про розширення MediaWiki

Babel Статус релізу: стабільний
Реалізація	Функція парсера
Опис	Додає функцію парсеру, щоб інформувати інших користувачів про знання мови та класифікувати користувачів тих же рівнів і мов.
Автор(и)	Robert Leverington (RobertLобговорення)
Найновіша версія	Continuous updates
Compatibility policy	Master maintains backward compatibility.
MediaWiki	1.36+
Зміни в БД	Yes
Composer	mediawiki/babel
Tables	babel
Ліцензія	GNU General Public License 2.0 or later
Завантажити	Включено в комплект мовних розширень Download extension Git [?]: Download Git master browse repository (Phabricator · GitHub) commit history repository contributors (GitHub) code review
Приклад	Translatewiki.net
Параметри $wgBabelMainCategory $wgBabelCategorizeNamespaces $wgBabelDefaultLevel $wgBabelCentralDb $wgBabelAutoCreate $wgBabelCategoryNames $wgBabelAllowOverride $wgBabelUseUserLanguage
Використані hook'и LinksUpdate LoadExtensionSchemaUpdates ParserFirstCallInit UserGetReservedNames
Quarterly downloads	107 (Ranked 70th)
Public wikis using	2,416 (Ranked 192nd)
Translate the Babel extension if it is available at translatewiki.net
Issues	Open tasks · Report a bug

Розширення Babel додає функцію парсеру щоб замінити стару систему Babel, яка повністю покладалася на шаблони. Якщо вказано нерозпізнаний параметр мови, він побачить, чи існує існуючий шаблон з ім’ям, і додасть його.

У проєктах Вікімедіа іменник Вавилон (що стосується Вавилонської вежі) відноситься до текстів на сторінках користувачів, які допомагають багатомовному спілкуванню, полегшуючи зв’язок з кимось, хто розмовляє певною мовою. Ідея виникла на Wikimedia Commons, а також була реалізована в багатьох інших вікі.

Завантаження

The extension can be retrieved directly from Git ^[?]:

• Browse code
• Some extensions have tags for stable releases.
  • Browse tags
  • Select the tag
  • Click "snapshot"
• Each branch is associated with a past MediaWiki release. There is also a "master" branch containing the latest alpha version (might require an alpha version of MediaWiki).
  • Browse branches
  • Select a branch name
  • Click "Продовжити"

Extract the snapshot and place it in the extensions/Babel/ directory of your MediaWiki installation.

If you are familiar with Git and have shell access to your server, you can also obtain the extension as follows:

cd extensions/ git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/Babel.git

Встановлення

• Завантажте і розмістіть файли в каталозі з назвою Babel у вашій extensions/ папці.
• Додайте такий код унизу вашого LocalSettings.php :

  wfLoadExtension( 'Babel' );
  

• Запустіть скрипт оновлення, який автоматично створить необхідні таблиці бази даних, які потрібні цьому розширенню.
• Налаштуйте як вимагається.
•  Готово – Перейдіть до Special:Version вашої вікі, щоб переконатися, що розширення встановлено успішно.

• CSS розташований у файлі resources/ext.babel.css. Ви можете змінити стиль за бажанням, перевизначивши їх на сторінці MediaWiki:Common.css.
• Якщо знайдено розширення CLDR , назви мов беруться з нього (де переклади недоступні), інакше використовуються вбудовані назви мов MediaWiki та англійська мова за замовчуванням.

Використання

Синтаксис функції парсеру #babel виглядає наступним чином:

 {{#babel: babelcode1 | babelcode2 | ... }}

Додайте один із наступних кодів для кожної мови, яку ви розмовляєте чи розумієте, відокремлюючись від |, де xx – це код мови MediaWiki, код ISO 639-1, або код ISO 639-3 для цієї мови. Загальне використання кожного рівня коду таке:

xx-0

Якщо ви взагалі не розумієте мови.

xx-1

Базові здібності — достатньо для розуміння письмового матеріалу або простих питань цією мовою.

xx-2

Середня здатність — достатньо для редагування або обговорення.

xx-3

Розширений рівень — хоча ви можете писати цією мовою без проблем, можуть виникнути невеликі помилки.

xx-4

Рівень «майже рідний» — хоча це не ваша перша мова від народження, ваші здібності схожі на здібності носія мови.

xx-5

Професійне володіння.

xx або xx-N

Носії мови, які щодня користуються мовою та досконало володіють нею, включаючи розмовні мови та ідіоми.

Щоб включити будь-який інший шаблон, просто додайте назву шаблону, напр. додайте Користувач з Лондона, якщо ви хочете включити Template:Користувач з Лондона. Залежно від локальної конфігурації до імен шаблонів (наприклад User) можна додати префікс або суфікс. Це можна використовувати для обмеження вибору та зменшення довжини параметрів; наприклад, з Лондона може включати Template:Користувач з Лондона, якщо налаштовано таким чином.

Щоб видалити верхній і нижній колонтитул, використовуйте plain=1 як перший параметр, напр. {{#babel: plain=1 | babelcode1 | babelcode2 | ... }}. Це полегшує використання babel з іншими юзербоксами.

Конфігурація

Параметри конфігурації

Babel має шість параметрів конфігурації, які можна змінити в LocalSettings.php .

$wgBabelLanguageCodesCdb

(string) шлях до файлу бази даних мовного коду, за замовчуванням має бути достатньо.

$wgBabelLanguageNamesCdb

(string) шлях до файлу бази даних назв мови, за замовчуванням має бути достатньо.

$wgBabelCategoryNames

(масив рядкових або логічних, індексований рядками «1», «2», … «5», «N») де кожен запис є назвою категорії для рівня кваліфікації, зазначеного його індексом, можливі змінні елементи: %code% (код мови), %wikiname% (назва мови мовою вмісту вікі), та %nativename% (назва мови на її мові). Щоб вимкнути додавання категорії для певного рівня, встановіть відповідне значення false.

Наприклад:

$wgBabelCategoryNames = [
	'0' => 'User %code%-0',
	'1' => 'User %code%-1',
	'2' => 'User %code%-2',
	'3' => 'User %code%-3',
	'4' => 'User %code%-4',
	'5' => 'User %code%-5',
	'N' => 'User %code%-N',
];

використовуватиме такі категорії, як «Category:User en-0» і «Category:User fr-N». За замовчуванням просто «Category:Fr-N» і так далі.

$wgBabelMainCategory

(string) Назва основної (нерівневої) категорії для кожної мови, до якої додаються всі користувачі цієї мови. Установіть значення false, щоб вимкнути; за замовчуванням формат «Category:Fr». Він приймає той самий формат, що й $wgBabelCategoryNames вище. приклад:

$wgBabelMainCategory = 'User %code%';

$wgBabelDefaultLevel

(string) Рівнем можливостей за замовчуванням, який не вказано, має бути індекс від $wgBabelCategoryNames, тобто один із рядків «1», «2», … «5», «N». За замовчуванням — «N».

$wgBabelUseUserLanguage

(boolean) Чи використовувати мову інтерфейсу користувача для заголовка та нижнього колонтитула повідомлення. Якщо значення false (за замовчуванням), це буде мова вмісту сторінки. Це пояснюється тим, що використання мови інтерфейсу користувача може фрагментувати кеш аналізатора.

$wgBabelCategorizeNamespaces

Array of namespaces to only add automatic categorization to. For example, if $wgBabelCategorizeNamespaces = [ NS_USER ];, then Babel will only add categories to pages in the user namespace. The default is null, which means categorize all namespaces.

$wgBabelCategoryOverride

Whether to allow Babel categories to be overridden on wiki using MediaWiki:Babel-category-override

$wgBabelAutoCreate

Whether to auto-create categories.

Системні повідомлення

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

MediaWiki:babel-template "Template:User $1"

Формат назв шаблонів, коли вони включені.

MediaWiki:babel-portal ""

Формат цілі посилання з коду мови. Set to the empty string to not link the language code.

MediaWiki:Babel-autocreate-user "Babel AutoCreate"

Ім’я користувача для автоматичного створення пов’язаних з Babel категорій

MediaWiki:babel-autocreate-text-levels "Користувачі із цієї категорії вказали рівень знань $1 для мови $2."

Текст для вставки в автоматично створені категорії для різних мовних рівнів. Ви повинні змінити це, якщо хочете, щоб вони автоматично класифікувалися в основній категорії відповідної мови ($wgBabelMainCategory).

MediaWiki:babel-autocreate-text-main "Користувачі в цій категорії вказали знання мови $1."

Текст для вставки в автоматично створені категорії для нерівневих категорій. Ви повинні змінити це, якщо хочете, щоб вони автоматично класифікувалися в батьківській категорії для всіх мов.

MediaWiki:babel "Відомості про мови користувача (Вавилон)"

Заголовок вікна babel Set to - to not display a header.

MediaWiki:babel-url "Project:Вавилон"

Назва сторінки, на якій можна знайти інформацію про розширення babel Set to - to display no link in the header.

MediaWiki:Babel-footer "Користувачі за мовою"

Нижній колонтитул babel Set to - to not display a footer.

MediaWiki:babel-footer-url " :Category:Користувачі за мовою"

Сторінка, на яку потрібно посилатися в нижньому колонтитулі вікна babel

MediaWiki:Babel-category-override "$1"

Overrides any automatically-generated Babel categories. Parameters:
$1 = the category that would be generated normally.
$2 = the language code
$3 is the babel level.
Any categories overridden using this method will not be auto-created to reduce the risk from vandalism or mistaken edits to that page.

meta=babel (bab)

(main | query | babel)

• This module requires read rights.
• Source: Babel
• License: GPL-2.0-or-later

Get information about what languages the user knows

Specific parameter:

Other general parameters are available.

babuser

User to get information about

This parameter is required.

Type: user, by any of username, IP, IP range and interwiki name (e.g. "prefix>ExampleName")

Example:

Get the Babel information for user Example

api.php?action=query&meta=babel&babuser=Example [open in sandbox]