Extension:Babel/cs

Category:GPL licensed extensions/cs
Příručka k rozšířením MediaWiki
Babel
Stav rozšíření: stabilníCategory:Stable extensions/cs
Implementace Funkce analyzátoru Category:Parser function extensions/cs
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/babelCategory:Extensions supporting Composer/cs
Tabulky babel
Licence GNU General Public License 2.0 nebo novější
Stáhnout Zahrnuto v balíčku jazykových rozšíření Category:Extensions in Wikimedia version control/cs
Příklad Translatewiki.net
  • $wgBabelMainCategory
  • $wgBabelAutoCreate
  • $wgBabelDefaultLevel
  • $wgBabelCategorizeNamespaces
  • $wgBabelUseUserLanguage
  • $wgBabelCentralDb
  • $wgBabelCategoryNames
  • $wgBabelUseCommunityConfiguration
  • $wgBabelAllowOverride
Přeložte rozšíření Babel, používá-li lokalizaci z translatewiki.net
Problémy Otevřené úkoly · Nahlásit chybu
Category:All extensions/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ž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.
  • Yes 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á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. 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í:

  1. Vytvořte šablonu {{Babel category }}, která bude generovat kategorie.
  2. Nahrazení textu na MediaWiki:babel-autocreate-text-levels za
    {{Babel category|level=$1|language=$2|ISO=$3}}
    
  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)

(main | query | babel)

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]
Category:Extensions used on Wikimedia/cs#Babel/cs Category:Localisation extensions/cs
Category:All extensions/cs Category:CommunityConfigurationProvider initList extensions/cs Category:Extensions in Wikimedia version control/cs Category:Extensions included in Canasta/cs Category:Extensions included in Miraheze/cs Category:Extensions included in ShoutWiki/cs Category:Extensions included in WikiForge/cs Category:Extensions included in wiki.gg/cs Category:Extensions supporting Composer/cs Category:Extensions used on Wikimedia/cs Category:GPL licensed extensions/cs Category:LinksUpdate extensions/cs Category:LoadExtensionSchemaUpdates extensions/cs Category:Localisation extensions/cs Category:ParserFirstCallInit extensions/cs Category:Parser function extensions/cs Category:Stable extensions/cs Category:UserGetReservedNames extensions/cs