Tillägg:Babel

This page is a translated version of the page Extension:Babel and the translation is 55% complete.
Manual för MediaWikitillägg
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.40.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
  • $wgBabelMainCategory
  • $wgBabelCategorizeNamespaces
  • $wgBabelDefaultLevel
  • $wgBabelCentralDb
  • $wgBabelAutoCreate
  • $wgBabelCategoryNames
  • $wgBabelAllowOverride
  • $wgBabelUseUserLanguage
Quarterly downloads 93 (Ranked 66th)
Public wikis using 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 din extensions/-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å sidan MediaWiki: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 eller xx-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:

  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 automatically categorize categories and if something happens, then simultaneously replace the categorization and text in all categories at the same time.


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 categorize all namespaces.
$wgBabelCategoryOverride
Whether to allow Babel categories to be overridden on 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 target of the link 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 autocreation 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 pagename 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)

(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]