Rozšíření:Babylón

Příručka k rozšířením MediaWiki

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.43.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í Stáhněte si rozšíření Git [?]: stáhněte si Git master procházení úložiště (Phabricator · GitHub) zobrazení historie přispěvatelé repozitáře (GitHub) kontrola kódu
Příklad	Translatewiki.net
Parametry $wgBabelMainCategory $wgBabelAutoCreate $wgBabelDefaultLevel $wgBabelCategorizeNamespaces $wgBabelUseUserLanguage $wgBabelCentralDb $wgBabelCategoryNames $wgBabelUseCommunityConfiguration $wgBabelAllowOverride
Použité háčky (hooks) CommunityConfigurationProvider_initList LinksUpdate LoadExtensionSchemaUpdates ParserFirstCallInit UserGetReservedNames
Čtvrtletní stahování	91 (Ranked 59th)
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žce extensions/.
  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ánce MediaWiki: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 nebo xx-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.

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í:

1. Vytvořte šablonu {{Babel category }}, která bude generovat kategorie.
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}}
   

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.

meta=babel (bab)

(main | query | babel)

• This module requires read rights.
• Source: Babel
• License: GPL-2.0-or-later

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]