Разширение:Babel
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 |
|
|
Quarterly downloads | 85 (Ranked 63rd) |
Public wikis using | 2,416 (Ranked 192nd) |
Преведете разширението Babel, ако е налично в translatewiki.net | |
Проблеми | Отворени задачи · Съобщете за грешка |
Разширението Babel добавя функция за парсер, за да замени старата система на Babel, която изцяло разчиташе на шаблони. Ако е посочен неразпознат езиков параметър, той ще види дали има съществуващ шаблон с името и ще го включи.
В проектите на Wikimedia съществителното Вавилон (във връзка с Вавилонската кула) се отнася до текстовете на потребителските страници, подпомагащи многоезичната комуникация, като улесняват свързването с някого който говори определен език. Идеята е възникнала в и е реализирана и в много други уикита.
Инсталиране
- Download and move the extracted
Babel
folder to yourextensions/
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:
- Create a template {{Babel category }} that will generate categories.
- Replacing text on MediaWiki:babel-autocreate-text-levels with
{{Babel category|level=$1|language=$2|ISO=$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)
- This module requires read rights.
- Source: Babel
- License: GPL-2.0-or-later
Get information about what languages the user knows
- 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")
- Get the Babel information for user Example
- api.php?action=query&meta=babel&babuser=Example [open in sandbox]
This extension is being used on one or more Wikimedia projects. This probably means that the extension is stable and works well enough to be used by such high-traffic websites. Look for this extension's name in Wikimedia's CommonSettings.php and InitialiseSettings.php configuration files to see where it's installed. A full list of the extensions installed on a particular wiki can be seen on the wiki's Special:Version page. |
This extension is included in the following wiki farms/hosts and/or packages: This is not an authoritative list. Some wiki farms/hosts and/or packages may contain this extension even if they are not listed here. Always check with your wiki farms/hosts or bundle to confirm. |