Tillägg:Babel
Babel Utgivningsstatus: stabil |
|
---|---|
Genomförande | Parserfunktion |
Beskrivning | Lägger till en parserfunktion för att informera andra användare om språkkunskaper och kategorisera användare på samma nivå och språk. |
Författare | Robert Leverington (RobertLdiskussion) |
Senaste versionen | Fortsatta uppdateringar |
Kompatibilitetsregler | Master maintains backward compatibility. |
MediaWiki | >= 1.41.0 |
Förändringar i databasen | Ja |
Composer | mediawiki/babel |
Tabeller | babel |
Licenser | GNU General Public License 2.0 eller senare |
Ladda ner | Ingår i språktilläggspaket (Language Extension Bundle) |
Exempel | Translatewiki.net |
|
|
Kvartalsnedladdningar | 64 (Ranked 71st) |
Offentliga wikier som använder | 2,416 (Ranked 192nd) |
Översätt tillägget Babel om det finns tillgängligt på translatewiki.net | |
Ärenden | Öppna ärenden · Rapportera en bugg |
Tillägget Babel lägger till en parserfunktion för att ersätta det gamla Babelsystemet som helt och hållet förlitade sig på mallar. Om ett oregistrerad språkparameter anges kommer den kolla om det finns en befintlig mall med samma namn och använda den.
På Wikimedias projekt refererar namnet Babel (från Babels torn) till texten på användarsidor som stöttar flerspråklig kommunikation genom att underlättar för folk att ta kontakt med någon som talar ett visst språk. Idén uppstod ursprungligen på Wikimedia Commons och har även implementerats på många fler wikier.
Installation
- Ladda ner och placera filen/filerna i en katalog som heter
Babel
i dinextensions/
-mapp.
Utvecklare och personer som bidrar med kod borde istället installera tillägget från Git, med:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/Babel - Lägg till följande kod längst ner i din LocalSettings.php -fil:
wfLoadExtension( 'Babel' );
- Kör uppdateringsskriptetsom automatiskt kommer skapa de nödvändiga databastabellerna som tillägget behöver.
- Konfigurera efter behov.
- Klart – Ta dig till Special:Version på din wiki för att bekräfta att tillägget har installerats ordentligt.
- CSS ligger i filen
resources/ext.babel.css
. Du kan ändra stilen efter behov genom att åsidosätta dem på sidanMediaWiki:Common.css
. - Om tillägget CLDR finns hämtas språknamn därifrån (där översättningar är otillgängliga), annars används de inbyggda namnen MediaWiki eller de förinställda engelska.
Användning
Syntaxen för parserfunktionen #babel
är följande:
{{#babel: babelcode1 | babelcode2 | ... }}
Lägg till en av följande koder för varje språk som du talar eller förstår, separerade av |
, där xx
är språkets språkkod på [[|
|MediaWiki]], i ISO 639-1 eller ISO 639-3. Den allmänna användningen av varje språknivå är följande:
xx-0
- Du förstår överhuvudet inte språket.
xx-1
- Grundläggande förmåga - tillräckligt för att förstå skrivet material eller enklare frågor på språket.
xx-2
- Medelförmåga - tillräckligt för att redigera eller diskutera.
xx-3
- Avancerad nivå - trots att du kan skriva på språket utan problem, kan mindre misstag uppstå.
xx-4
- "Som infödd"-nivå - trots att det inte är ditt modersmål, är din förmåga i stil med modersmålstalare.
xx-5
- Professionell förmåga.
xx
ellerxx-N
- Modersmålstalare som använder språket varje dag och har en grundlig förståelse av det, med uttryck och slang inräknat.
För att infoga andra mallar, lägg helt enkelt till mallens namn, t.ex. Användar-CSS
om du vill lägga till Mall:Användar-CSS
. Ett prefix eller suffix kan läggas till mallnamn (t.ex. Användare
i början) beroende på lokal konfigurering. Detta kan begränsa urvalet och reducera längden på parametrar; till exempel skulle CSS
kunna infoga Mall:Användar-CSS
om det konfigurerats så.
Parameters
För att ta bort rubriken och sidfoten behöver du använda plain=1
som den första parametern, {{#babel: plain=1 | babelcode1 | babelcode2 | ... }}
, t.ex.
Detta underlättar användningen av babel med andra användarrutor.
To hide categories, use the nocat=1
parameter as the first parameter, e.g., {{#babel: nocat=1 | babelcode1 | babelcode2 | ... }}
.
Please note that only one of the parameters above is allowed.
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.
Konfiguration
Konfigureringsparametrar
Babel har sex konfigureringsparametrar som kan modifieras i LocalSettings.php
.
$wgBabelLanguageCodesCdb
- (sträng) sökväg för filen i språkkodsdatabasen, standard borde räcka.
$wgBabelLanguageNamesCdb
- (sträng) sökväg för filen i språkkodsdatabasen, standard borde räcka.
$wgBabelCategoryNames
- (array of string or boolean, indexed by the strings "1", "2", … "5", "N") where each entry is the name of a category for the skill level indicated by its index, possible variable elements are:
%code%
(language code),%wikiname%
(the name of the language in the wiki's content language), and%nativename%
(the name of the language in its language). To disable adding a category for a particular level, set the corresponding value to false.
- For example:
$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',
];
- will use categories like "Category:User en-0" and "Category:User fr-N". The default is just "Category:Fr-N" and so on.
$wgBabelMainCategory
- (string) Name of the main (non-level) category for each language to which all users of that language are added. Set to false to disable; defaults to format "Category:Fr". It accepts the same format as
$wgBabelCategoryNames
above. Example:$wgBabelMainCategory = 'User %code%';
$wgBabelDefaultLevel
- (string) Default ability level to use when none is specified, should be an index from
$wgBabelCategoryNames
, that is one of the strings "1", "2", … "5", "N". Default is "N". $wgBabelUseUserLanguage
- (boolean) Whether to use the user interface language for the header and footer message. If false (default), it will be in the page content language. This is because using the user interface language may fragment the parser cache.
$wgBabelCategorizeNamespaces
- Array of namespaces to only add automatic categorization to. For example, if
$wgBabelCategorizeNamespaces = [ NS_USER ];
, then Babel will only add categories to pages in the user namespace. The default is null, which means categorizing all namespaces. $wgBabelCategoryOverride
- Whether to allow Babel categories to be overridden on the wiki using MediaWiki:Babel-category-override
$wgBabelAutoCreate
- Whether to auto-create categories.
Systemmeddelanden
Several customizations can also be made using MediaWiki namespace messages.
- MediaWiki:babel-template "
Template:Användare $1
" - The format of template names when one is being included.
- MediaWiki:babel-portal "
"
- The format of the link's target from the language code. Set to the empty string to not link the language code.
- MediaWiki:Babel-autocreate-user "
Babel AutoCreate
" - Username to be used for auto-creation of Babel related categories
- MediaWiki:babel-autocreate-text-levels "
Användare i den här kategorin indikerar att de kan språket $2 på en kunskapsnivå av $1.
" - Text to insert into auto-created categories for different language levels. You have to change this if you want them to be auto-categorized in the main category of the respective language (
$wgBabelMainCategory
). - MediaWiki:babel-autocreate-text-main "
Användare i den här kategorin indikerar att de har kunskap i språket $1.
" - Text to insert into auto-created categories for non-level categories. You have to change this if you want them to be auto-categorized in a parent category for all languages.
- MediaWiki:babel "
Babel-användarinformation
" - The header of the babel box. Set to
-
to not display a header. - MediaWiki:babel-url "
Project:Babel
" - The page name where information on the babel extension can be found. Set to
-
to display no link in the header. - MediaWiki:Babel-footer "
Användare efter språk
" - The footer of the babel box. Set to
-
to not display a footer. - MediaWiki:babel-footer-url "
:Kategori:Babel - Användare efter språk
" - The page to link to in the footer of the babel box
- MediaWiki:Babel-category-override "
$1
" - Overrides any automatically-generated Babel categories. Parametrar:
$1 = kategorin som vanligtvis skulle genererats.
$2 = språkkoden
$3 = babel-nivån.
Alla kategorier som åsidosatts med denna metod kommer inte automatiskt skapas för att minska risken för vandalism eller felaktiga redigeringar på den sidan.
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]
Det här tillägget används på ett eller fler av Wikimedias projekt. Det betyder förmodligen att tillägget är stabilt och fungerar tillräckligt bra för att användas på högtrafikerade hemsidor. Leta efter tilläggets namn i Wikimedias CommonSettings.php och InitialiseSettings.php-konfigureringsfiler för att se var det har installerats. En fullständig lista över tillägg som installerats på en wiki finns på wikins Special:Version-sida. |
Tillägget ingår i följande wikihotell och/eller paket: Detta är inte en auktoritär lista. Vissa wikihotell och/eller paket kan innehålla detta tillägg även om de inte listas här. Kontrollera alltid med ditt wikihotell eller -bunt för bekräftelse. |