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

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

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

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

Инсталиране

  • Download and move the extracted Babel folder to your extensions/ directory.
    Developers and code contributors should install the extension from Git instead, using:cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/Babel
  • На дъното на вашия $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
носители на роден език, които използват език всеки ден и го разбират задълбочено, включително разговорни и идиоми.

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

Parameters

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

To hide categories, use the nocat=1 parameter as the first parameter, e.g., {{#babel: nocat=1 | babelcode1 | babelcode2 | ... }}.

Please note that only one of the parameters above is allowed. At the moment, it is not possible to use both parameters; for example, {{#babel: nocat=1 | plain=1 | babelcode1 | babelcode2 | ... }} will not work.

Categorization

If categorization is enabled, the extension creates categories using the Babel AutoCreate bot with the text specified in MediaWiki:babel-autocreate-text-levels and MediaWiki:babel-autocreate-text-main. With basic settings, the categories that the bot creates are not categorized, and to fix this, it is recommended to do the following:

  1. Create a template {{Babel category }} that will generate categories.
  2. Replacing text on MediaWiki:babel-autocreate-text-levels with
    {{Babel category|level=$1|language=$2|ISO=$3}}
    
  3. Replacing text on MediaWiki:babel-autocreate-text-main with
    {{Babel category|language=$1|ISO=$2}}
    

This will allow you to categorize categories automatically, and if something happens, you can simultaneously replace the categorization and text in all categories.

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

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

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 categorizing all namespaces.
$wgBabelCategoryOverride
Whether to allow Babel categories to be overridden on the wiki using MediaWiki:Babel-category-override
$wgBabelAutoCreate
Whether to auto-create categories.

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

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

MediaWiki:babel-template "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 = the babel level.
Any categories overridden using this method will not be auto-created to reduce the risk of vandalism or mistaken edits to that page.

API

meta=babel (bab)

(main | query | babel)

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, Temporary user, 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]