Tillägg:Babel
Babel Utgivningsstatus: stabil |
|
---|---|
![]() |
|
Genomförande | Parsertillägg |
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 | Continuous updates |
Kompatibilitetsregler | Master maintains backwards compatibility. |
MediaWiki | 1.30+ |
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 |
|
|
Ö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.
Ladda ner
Tillägget kan hämtas direkt från Git [?]:
- Bläddra i koden
- Vissa tillägg har taggar för stabila versioner.
- Bläddra bland taggar
- Välj taggar
- Klicka "snapshot"
- Varje gren associeras med en tidigare MediaWiki-version. Det finns också en "master"-gren som innehåller den senaste alfaversionen (kan kräva en alfaversion av MediaWiki).
- Bläddra bland grenar
- Välj ett grennamn
- Klicka "Fortsätt"
Extract the snapshot and place it in the extensions/Babel/ directory of your MediaWiki installation.
If you are familiar with git and have shell access to your server, you can also obtain the extension as follows:
cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/Babel.git
Installation
- Ladda ner och placera filen/filerna i en katalog som heter
Babel
i dinextensions/
-mapp. - Lägg till följande kod längst ner i dina LocalSettings.php:
wfLoadExtension( 'Babel' );
- 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ändare från Göteborg
om du vill lägga till Mall:Användare från Göteborg
. 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 från Göteborg
kunna infoga Mall:Användare från Göteborg
om det konfigurerats så.
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.
Konfiguration
Konfigureringsparametrar
Babel har sex konfigureringsparametrar som kan modifieras i LocalSettings.php
.
$wgBabelLanguageCodesCdb
- (string) the path of the language code database file, the default should suffice.
$wgBabelLanguageNamesCdb
- (string) the path of the language name database file, the default should suffice.
$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.
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 "
⧼babel-portal⧽
" - The format of the target of the link from 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
- MediaWiki:babel-url "
Project:Babel
" - The pagename where information on the babel extension can be found
- MediaWiki:Babel-footer "
Användare efter språk
" - The footer of the babel box
- MediaWiki:babel-footer-url "
:Kategori:Babel - Användare efter språk
" - The page to link to in the footer of the babel box
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 user name, IP, 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. |