Rozšíření:Babylón
Babel Stav rozšíření: stabilní |
|
---|---|
Implementace | Funkce analyzátoru |
Popis | Přidává parser function, která informuje ostatní uživatele o jazykových znalostech daného uživatele a kategorizuje uživatele stejných úrovní a jazyků. |
Autoři | Robert Leverington (RobertLdiskuse) |
Nejnovější verze | průběžné aktualizace |
Zásady kompatibility | Větev master zachovává zpětnou kompatibilitu. |
MediaWiki | >= 1.41.0 |
Změny v databázi | Ano |
Composer | mediawiki/babel |
Tabulky | babel |
Licence | GNU General Public License 2.0 nebo novější |
Stáhnout | Zahrnuto v balíčku jazykových rozšíření |
Příklad | Translatewiki.net |
|
|
Čtvrtletní stahování | 65 (Ranked 71st) |
Veřejné wiki používající rozšíření | 2,416 (Ranked 192nd) |
Přeložte rozšíření Babel, používá-li lokalizaci z translatewiki.net | |
Problémy | Otevřené úkoly · Nahlásit chybu |
Rozšíření Babylón přidává parser function, funkci která nahrazuje starý systém Babylón, který zcela spoléhal na šablony. Pokud je zadán parametr nerozpoznaného jazyka, uvidí, zda existuje šablona s názvem, a případně ji zahrne.
Na projektech Wikimedia se podstatné jméno Babel (v odkazu na Babylonská věž) vztahuje k textům na uživatelských stránkách, které pomáhají vícejazyčné komunikaci tím, že usnadňují kontakt s někým, kdo mluví určitým jazykem. Tato myšlenka vznikla na Wikimedia Commons a byla implementována i na mnoha dalších wiki.
Instalace
- Stáhněte soubor/y a vložte je do adresáře pojmenovaného
Babel
ve vaší složceextensions/
.
Vývojáři a přispěvatelé kódu by si místo toho měli nainstalovat rozšíření from Git pomocí:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/Babel - Na konec vašeho souboru LocalSettings.php přidejte následující kód:
wfLoadExtension( 'Babel' );
- Spusťte aktualizační skript, který automaticky provede všechny nezbytné databázové změny, jaké rozšíření vyžaduje.
- Vyžaduje nastavení v konfiguračním souboru.
- Dokončeno – Přejděte na stránku Special:Version vaší wiki a zkontrolujte, zda bylo rozšíření úspěšně nainstalováno.
- CSS se nachází v souboru
resources/ext.babel.css
. Styl můžete změnit podle potřeby jeho přepsáním na stránceMediaWiki:Common.css
. - Pokud je nalezeno rozšíření CLDR , převezmou se z něj názvy jazyků (pokud nejsou k dispozici překlady), jinak se použijí vestavěné názvy jazyků MediaWiki a výchozí anglické názvy.
Použití
Syntaxe funkce #babel
parser je následující:
{{#babel: babelcode1 | babelcode2 | ... }}
Přidejte jeden z následujících kódů pro každý jazyk, kterým mluvíte nebo kterému rozumíte, oddělený |
, kde xx
je kód jazyka, ISO 639-1 kód MediaWiki nebo ISO 639-3 kód jazyka. Obecné použití jednotlivých úrovní kódu je následující:
xx-0
- Pokud nerozumíte danému jazyku.
xx-1
- Základní znalost jazyku. Dokážete pochopit základní text a otázky v daném jazyce.
xx-2
- Středně pokročilá schopnost. Dokážete provádět úpravy textu nebo diskutovat s ostatními.
xx-3
- Pokročilá úroveň. Ovládáte tento jazyk, ale mohou se vyskytnout drobné chyby.
xx-4
- "Téměř rodilý mluvčí". Není to Váš první jazyk, ale blížíte se téměř rodilému mluvčímu.
xx-5
- Profesionální znalost jazyka.
xx
neboxx-N
- Rodilí mluvčí, kteří používají jazyk každý den a dokonale jej ovládají, včetně hovorových výrazů a idiomů.
Chcete-li zahrnout jakoukoli jinou šablonu, jednoduše přidejte její název, např. přidejte User CSS
, chcete-li zahrnout Šablona:User CSS
. K názvům šablon může být přidána předpona nebo přípona (např. User
na začátek) v závislosti na místní konfiguraci. Toho lze využít k omezení výběru a zkrácení délky parametrů; například CSS
by mohl obsahovat Šablona:Uživatel CSS
, pokud je takto nakonfigurován.
Parametry
Chcete-li odstranit záhlaví a zápatí, použijte jako první parametr plain=1
, např. {{#babel: plain=1 | babelcode1 | babelcode2 | ... }}
.
To usnadňuje používání aplikace babel s jinými uživatelskými schránkami.
To hide categories, use the nocat=1
parameter as the first parameter, e.g., {{#babel: nocat=1 | babelcode1 | babelcode2 | ... }}
.
Upozorňujeme, že je povolen pouze jeden z výše uvedených parametrů.
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.
Konfigurace
Parametry konfigurace
Babel má několik konfiguračních parametrů, které lze upravit v LocalSettings.php
.
$wgBabelLanguageCodesCdb
- (string) cesta k souboru databáze jazykových kódů, výchozí hodnota by měla stačit.
$wgBabelLanguageNamesCdb
- (řetězec) cesta k databázovému souboru s názvem jazyka, výchozí hodnota by měla stačit.
$wgBabelCategoryNames
- (pole řetězců nebo boolean, indexované řetězci "1", "2", ... "5", "N"), kde každá položka je název kategorie pro úroveň dovedností označenou jejím indexem, možné prvky proměnné jsou: 1 (kód jazyka), 2 (název jazyka v jazyce obsahu wiki) a 3 (název jazyka v jeho jazyce). Chcete-li přidání kategorie pro určitou úroveň zakázat, nastavte odpovídající hodnotu na false.
Například:
$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',
];
- bude používat kategorie jako "Category:User en-0" a "Category:User fr-N". Výchozí je pouze "Category:Fr-N" a tak dále.
$wgBabelMainCategory
- (string) Název hlavní (neúrovňové) kategorie pro každý jazyk, do které jsou přidáni všichni uživatelé daného jazyka. Nastavte false pro vypnutí; výchozí formát je "Category:Fr". Přijímá stejný formát jako
$wgBabelCategoryNames
výše. Příklad:$wgBabelMainCategory = 'User %code%';
$wgBabelDefaultLevel
- (string) Výchozí úroveň schopnosti, která se použije, pokud není zadána žádná, měl by to být index z
$wgBabelCategoryNames
, což je jeden z řetězců "1", "2", ... "5", "N". Výchozí hodnota je "N". $wgBabelUseUserLanguage
- (boolean) Zda se má pro zprávu v záhlaví a zápatí použít jazyk uživatelského rozhraní. Pokud false (výchozí), bude v jazyce obsahu stránky. Je to proto, že použití jazyka uživatelského rozhraní může fragmentovat mezipaměť parseru.
$wgBabelCategorizeNamespaces
- Pole jmenných prostorů, do kterých se přidává pouze automatická kategorizace. Například pokud
$wgBabelCategorizeNamespaces = [ NS_USER ];
, pak Babel přidá kategorie pouze na stránky v uživatelském jmenném prostoru. Výchozí hodnota je null, což znamená kategorizovat všechny jmenné prostory. $wgBabelCategoryOverride
- Zda povolit přepsání kategorií Babel na wiki pomocí MediaWiki:Babel-category-override
$wgBabelAutoCreate
- Zda se mají automaticky vytvářet kategorie.
Systémové zprávy
Několik úprav lze provést také pomocí zpráv jmenného prostoru MediaWiki.
- MediaWiki:babel-template "
Template:User $1
" - Formát názvů šablon, pokud je jedna z nich zahrnuta.
- MediaWiki:babel-portal "
"
- Formát cíle odkazu z kódu jazyka. Nastavte na prázdný řetězec, aby se kód jazyka nepropojoval.
- MediaWiki:Babel-autocreate-user "
Babel AutoCreate
" - Uživatelské jméno, které se použije pro automatické vytváření kategorií souvisejících s Babel
- MediaWiki:babel-autocreate-text-levels "
Uživatelé v této kategorii označili svou úroveň znalostí jazyka $2 jako $1.
" - Vložení textu do automaticky vytvořených kategorií pro různé jazykové úrovně. Pokud chcete, aby byly automaticky zařazeny do hlavní kategorie příslušného jazyka (
$wgBabelMainCategory
), musíte tento údaj změnit. - MediaWiki:babel-autocreate-text-main "
Uživatelé v této kategorii se přihlásili ke znalosti jazyka $1.
" - Text, který se vkládá do automaticky vytvořených kategorií pro kategorie, které nejsou na úrovni. Pokud chcete, aby byly automaticky zařazeny do nadřazené kategorie pro všechny jazyky, musíte tento údaj změnit.
- MediaWiki:babel "
Babylon – informace o uživateli
" - Záhlaví babel boxu. Nastavte na
-
, aby se záhlaví nezobrazovalo. - MediaWiki:babel-url "
Project:Babylon
" - Název stránky, kde lze nalézt informace o rozšíření babel. Set to
-
to display no link in the header. - MediaWiki:Babel-footer "
Uživatelé podle jazyka
" - The footer of the babel box. Set to
-
to not display a footer. - MediaWiki:babel-footer-url "
:Kategorie:Babylon – Uživatelé podle jazyka
" - The page to link to in the footer of the babel box
- 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]
Toto rozšíření se používá na jednom nebo více projektech Wikimedia. Pravděpodobně to znamená, že rozšíření je stabilní a funguje dostatečně dobře, aby jej mohly používat weby s tak vysokou návštěvností. Vyhledejte tento název rozšíření v konfiguračních souborech CommonSettings.php a InitialiseSettings.php Wikimedie, abyste viděli, kde je nainstalováno. Úplný seznam rozšíření nainstalovaných na konkrétní wiki lze vidět na stránce wiki Special:Version. |
Toto rozšíření je zahrnuto v následujících wiki farmách/hostitelích a/nebo balíčcích: Toto není autoritativní seznam. Některé wiki farmy/hostitelé a/nebo balíčky mohou toto rozšíření obsahovat, i když zde nejsou uvedeny. Pro potvrzení se vždy obraťte na své wiki farmy/hostitele nebo balíček. |