Разширение:Babel

This page is a translated version of the page Extension:Babel and the translation is 86% complete.
Outdated translations are marked like this.
Ръководство за МедияУики разширения
Babel
Обявен статут: стабилен
Реализация Parser extension
Описание Добавя функция за парсер, за да информира другите потребители за владеенето на езика и да категоризира потребителите със същите нива и езици.
Автор(и) Robert Leverington (RobertLбеседа)
Най-нова версия Continuous updates
Правило за съвместимост Master maintains backward compatibility.
MediaWiki 1.36+
Промени в базата данни Да
Composer mediawiki/babel
Таблици babel
Лиценз GNU General Public License 2.0 or later
Изтегляне Включен в пакета езикови разширения
Пример Translatewiki.net
  • $wgBabelMainCategory
  • $wgBabelCategorizeNamespaces
  • $wgBabelDefaultLevel
  • $wgBabelCentralDb
  • $wgBabelCategoryNames
  • $wgBabelAllowOverride
  • $wgBabelUseUserLanguage
Quarterly downloads 97 (Ranked 95th)
Public wikis using 2,416 (Ranked 192nd)
Преведете разширението Babel, ако е налично в translatewiki.net
Проблеми Отворени задачи · Съобщете за грешка

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

В проектите на Wikimedia съществителното Вавилон (във връзка с Вавилонската кула) се отнася до текстовете на потребителските страници, подпомагащи многоезичната комуникация, като улесняват свързването с някого който говори определен език. Идеята е възникнала в и е реализирана и в много други уикита.

Изтегляне

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

  • Browse code
  • Some extensions have tags for stable releases.
  • 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).

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

Инсталиране

  • Download and place the file(s) in a directory called Babel in your extensions/ folder.
  • На дъното на вашия $LocalSettings добавете следния код:
    wfLoadExtension( 'Babel' );
    
  • Изпълнете скрипта за поднова, който автоматично ще създаде нужните таблици в базата данни, които използват се от това разширение.
  • Конфигурирайте според изискванията.
  •   Готово – Отидете на Special:Version в уикито си, за да проверите дали разширението е успешно инсталирано.
  • CSS се намира във файла resources/ext.babel.css. Можете да промените стила, както желаете, като ги замените в MediaWiki:Common.css на страницата.
  • Ако бъде намерено разширението CLDR , имената на езици са взети от него (където преводите не са налични), в противен случай се използват вградени имена на езици в MediaWiki и английски по подразбиране.

Употреба

Синтаксисът за функцията #babel parser е както следва

 {{#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
носители на роден език, които използват език всеки ден и го разбират задълбочено, включително разговорни и идиоми.

За да включите друг шаблон, просто добавете името на шаблона, напр. добавете Потребител от Лондон, ако искате да включите Шаблон:Потребител от Лондон. Към имената на шаблони може да се добави префикс или суфикс (напр. Потребител в началото) в зависимост от локалната конфигурация. Това може да се използва за ограничаване на избора и намаляване на дължината на параметрите; например от Лондон може да включва Шаблон:Потребител от Лондон, ако е конфигуриран по такъв начин.

За да премахнете горния и долния колонтитул, използвайте plain=1 като първи параметър, напр. $обикновен. Това улеснява използването на babel с други потребителски кутии.


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

Конфигуриране на променливи

Babel има шест конфигурационни параметъра, които могат да се променят в LocalSettings.php .

$wgBabelLanguageCodesCdb
(низ) пътя на файла с базата данни с езиков код, по подразбиране трябва да е достатъчно.
$wgBabelLanguageNamesCdb
(низ) пътя на файла с базата данни с езиков код, по подразбиране трябва да е достатъчно.
$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
(низ) Име на основната (не-ниво) категория за всеки език, към която са добавени всички потребители на този език. Задайте false за деактивиране; по подразбиране форматира "Категория:Fr". Той приема същия формат като $wgBabelCategoryNames по-горе. пример:
$wgBabelMainCategory = 'User %code%';
$wgBabelDefaultLevel
(низ) Нивото на способност по подразбиране, което да се използва, когато не е посочено, трябва да бъде индекс от $wgBabelCategoryNames, което е един от низовете "1", "2", ... "5", "N". По подразбиране е "N".
$wgBabelUseUserLanguage
(булева стойност) Дали да се използва езикът на потребителския интерфейс за съобщението в горния и долния колонтитул. Ако е 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

Системни съобщения

Няколко персонализации също могат да бъдат направени с помощта на съобщения за пространство от имена на MediaWiki.

MediaWiki:babel-template "Шаблон:Потребител $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 "Потребителите в тази категория са посочили, че владеят $2 език на $1 ниво."
Текст за вмъкване в автоматично създадени категории за различни езикови нива. Трябва да промените това, ако искате те да бъдат автоматично категоризирани в основната категория на съответния език ($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.

API

meta=babel (bab)

(main | query | babel)

Get information about what languages the user knows

Parameter:
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]