Erweiterung:Babel

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page Extension:Babel and the translation is 47% complete.

Other languages:
Deutsch • ‎English • ‎Lëtzebuergesch • ‎Scots • ‎asturianu • ‎dansk • ‎español • ‎français • ‎italiano • ‎lietuvių • ‎magyar • ‎polski • ‎português do Brasil • ‎sicilianu • ‎български • ‎русский • ‎हिन्दी • ‎মেইতেই লোন্ • ‎中文 • ‎日本語 • ‎조선말 • ‎한국어
MediaWiki-Erweiterungen
OOjs UI icon advanced.svg
Babel
Erscheinungsstatus: stabil
Babel-extension-screenshot.png
Einbindung Parser extension
Beschreibung Fügt eine Parserfunktion hinzu um andere Benutzer über Sprachkenntnisse zu informieren und um Benutzer mit gleichen Sprachlevels zu kategorisieren.
Autor(en) Robert Leverington (RobertLtalk)
Letzte Version Continuous updates
MediaWiki 1.30+
Datenbankänderungen Nein
Composer mediawiki/babel
Tabellen babel
Lizenz GNU General Public License 2.0 or later
Herunterladen Im Sprachenerweiterungsbündel enthalten
Beispiel Translatewiki.net
Parameter
  • $wgBabelCategorizeNamespaces
  • $wgBabelCategoryNames
  • $wgBabelMainCategory
  • $wgBabelDefaultLevel
  • $wgBabelUseUserLanguage
  • $wgBabelUseDatabase
  • $wgBabelCentralDb
  • $wgBabelCentralApi
Verwendete Hooks
ParserFirstCallInit
LinksUpdate
LoadExtensionSchemaUpdates
UserGetReservedNames
Übersetze die Babel Erweiterung wenn sie auf translatewiki.net verfügbar ist
Prüfe die Benutzungs- und Versionsmatrix.
Probleme Offene Aufgaben · Einen Fehler melden

The Babel extension adds a parser function to replace the old Babel system that completely relied on templates. If an unrecognized language parameter is specified, it will see if there is an existing template with the name and include that.

On Wikimedia projects, the noun Babel (in reference to the Tower of Babel) refers to the texts on user pages aiding multilingual communication by making it easier to contact someone who speaks a certain language. The idea originated on the Wikimedia Commons and has also been implemented on many other wikis.

Download

Die Erweiterung kann man direkt von Git erhalten [?]:

  • Den Code ansehen
  • Einige Erweiterungen haben Hinweise für stabile Releases.
  • Jeder Zweig ist mit einem vergangenen MediaWiki Release assoziiert. Es gibt außerdem einen „Master“-Zweig, der die aktuellste Alpha-Version enthält (dies könnte eine Alpha von MediaWiki erfordern).

Extrahiere den Snapshot und kopiere ihn in das extensions/Babel/-Verzeichnis der MediaWiki-Installation.

Falls man sich mit git auskennt und einen Konsolen-Zugang zum Server hat, kann man die Erweiterung auch so bekommen:

cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/Babel.git

Installation

  • Füge folgenden Code am Ende deiner LocalSettings.php hinzu:
    wfLoadExtension( 'Babel' );
    
  • Configure as required.
  • Yes Erledigt – Navigiere zu Special:Version in deinem Wiki (bei Einstellung auf deutsch nach Spezial:Version), um zu prüfen, dass die Erweiterung erfolgreich installiert ist.

An Nutzer, die MediaWiki 1.25 und früher betreiben:

Die oben stehenden Anweisungen beschreiben den neuen Weg der Installation von diese Erweiterung per wfLoadExtension(). Falls du diese Erweiterung in einer dieser früheren Versionen (MediaWiki 1.25 und früher)  – an Stelle von wfLoadExtension( 'Babel' ); – installieren musst, benutze:

require_once "$IP/extensions/Babel/Babel.php";
  • The CSS is located in the file resources/ext.babel.css. You can change the style as desired by overriding them in the page MediaWiki:Common.css.
  • If the CLDR extension is found language names are taken from that (where translations are unavailable), otherwise built in MediaWiki language names and English defaults are used.

Verwendung

Die Syntax der #babel-Parserfunktion ist folgende:

 {{#babel: babelcode1 | babelcode2 | ... }}

Es wird einer der folgenden Codes für jede Sprache hinzugefügt, die gesprochen oder verstanden wird, getrennt durch |, wobei xx der MediaWiki-Sprachcode nach ISO 639-1-Sprachennorm oder nach ISO 639-3-Sprachennorm ist. Die allgemeine Verwendung jeder Ebene des Codes ist wie folgt:

xx-0
Wenn die Sprache gar nicht verstanden wird.
xx-1
Grundkenntnisse - genug um geschriebenes Material oder einfache Fragen in dieser Sprache zu verstehen.
xx-2
Mittlere Kenntnisse - genug für Bearbeitungen oder Diskussionen.
xx-3
Fortgeschrittenes Niveau - obwohl in dieser Sprache ohne Probleme geschrieben werden kann, können einige kleine Fehler auftreten.
xx-4
"Nahe-muttersprachliches" Niveau - obwohl des nicht die erste Sprache von Geburt an ist, sind die Fähigkeiten nahe dem eines Muttersprachlers.
xx-5
Professionelle Kenntnisse.
xx oder xx-N
Muttersprachler, die jeden Tag diese Sprache benutzen und ein gründliches Verständnis davon haben, einschließlich der Umgangssprache und Redewendungen.

To include any other template, simply add the name of the template, e.g. add User from London if you want to include Template:User from London. 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 from London could include Template:User from London if configured in such a way.

Zum Entfernen der Kopf- oder Fußzeile, kann plain=1 als erster Parameter verwendet werden, z.B. {{#babel: plain=1 | babelcode1 | babelcode2 | ... }}. This makes it easier to use babel with other userboxes.

Konfiguration

Configuration parameters

Babel has six configuration parameters which can be modified in 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.
Zum Beispiel:
$wgBabelCategoryNames = array(
	'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.

System messages

Several customizations can also be made using MediaWiki namespace messages.

MediaWiki:babel-template "Template:User $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 "Benutzer in dieser Kategorie haben Kenntnisse der Stufe $1 in der Sprache $2."
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 "Benutzer in dieser Kategorie haben Kenntnisse der Sprache $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 – Benutzerinformationen"
Der Kopf der Babelbox
MediaWiki:babel-url "Project:Babel"
The pagename where information on the babel extension can be found
MediaWiki:Babel-footer "Benutzer nach Sprache"
Die Fußzeile der Babelbox
MediaWiki:babel-footer-url " :Category:Babel - Benutzer nach Sprache"
Die Seite, zu der die Fußzeile der Babelbox verlinkt werden soll

API

meta=babel (bab)

(main | query | babel)

Get information about what languages the user knows

Parameter:
babuser

User to get information about

This parameter is required.
Type: user name
Example:
Get the Babel information for user Example
api.php?action=query&meta=babel&babuser=Example [open in sandbox]