Extension:Babel/cs
Rozšíření Babel definuje parserovou funkci s názvem #babel
, kterou mohou uživatelé umístit na svou uživatelskou stránku, aby označili svou znalost různých jazyků.
This information can then additionally be stored via categories, allowing others to find users who speak any particular language.
Toto rozšíření má nahradit předchozí systém, nazývaný také "Babel" (v odkazu na Babylonskou věž), který se zcela spoléhal na šablony. Nápad vznikl na Wikimedia Commons, poté se rozšířil do dalších projektů Wikimedia a později byl implementován na mnoha dalších wiki.
Rozšíření Babel stále používá šablony: pokud je zadán parametr nerozpoznaného jazyka, rozšíření zjistí, zda existuje šablona s tímto názvem, a pokud ano, zahrne ji.
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.less
. 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.
A prefix or suffix may be added to template names (e.g., User
at the beginning) depending on the local configuration.
This can be used to restrict the selection and reduce the length of parameters; for example, CSS
could include Template:User CSS
if configured in such a way.
For example in the mentioned case of CSS (Cascading Style Sheets), it might collide with the ISO code for Southern Ohlone language.
In such case, to enforce the usage of a local template, simply prefix the parameter with an underscore (_
).
E.g. … html-3|_css-2|js-1 …
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.
Chcete-li skrýt kategorie, použijte parametr nocat=1
jako první parametr, např. {{#babel: nocat=1 | babelcode1 | babelcode2 | ... }}
.
Upozorňujeme, že je povolen pouze jeden z výše uvedených parametrů.
V současné době není možné použít oba parametry. Například {{#babel: nocat=1 | plain=1 | babelcode1 | babelcode2 | ... }}
nebude fungovat.
Kategorizace
Pokud je kategorizace povolena, rozšíření vytvoří kategorie pomocí robota Babel AutoCreate s textem specifikovaným v MediaWiki:babel-autocreate-text-levels a MediaWiki:babel-autocreate-text-main. Se základním nastavením nejsou kategorie, které robot vytváří, kategorizovány a pro vyřešení tohoto problému se doporučuje provést následující:
- Vytvořte šablonu {{Babel category}}, která bude generovat kategorie.
- Nahrazení textu na MediaWiki:babel-autocreate-text-levels za
{{Babel category|level=$1|language=$2|ISO=$3}}
- Nahrazení textu na MediaWiki:babel-autocreate-text-main za
{{Babel category|language=$1|ISO=$2}}
To vám umožní automaticky kategorizovat kategorie, a pokud se něco stane, můžete současně nahradit kategorizaci a text ve všech kategoriích.
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. Nastavte na
-
, aby se v záhlaví nezobrazoval žádný odkaz. - MediaWiki:Babel-footer "
Uživatelé podle jazyka
" - Zápatí babel boxu. Pokud chcete nezobrazovat zápatí, nastavte na
-
. - MediaWiki:babel-footer-url "
:Kategorie:Babylon – Uživatelé podle jazyka
" - Stránka, na kterou se má odkazovat v zápatí babel boxu
- MediaWiki:Babel-category-override "
$1
" - Přepíše všechny automaticky generované kategorie Babel. Parametry:
$1 = kategorie, která by se normálně vygenerovala.
$2 = kód jazyka
$3 = úroveň Babelu.
Žádné kategorie přepsané pomocí této metody nebudou automaticky vytvořeny, aby se snížilo riziko vandalismu nebo chybných úprav na dané stránce.
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. |