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í	85 (Ranked 57th)
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.

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:

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.

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.

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]