Erweiterung:Babel

This page is a translated version of the page Extension:Babel and the translation is 100% complete.
MediaWiki-Erweiterungen
Babel
Freigabestatus: stabil
Einbindung Parser-Funktion
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 (RobertLDiskussion)
Letzte Version Laufende Aktualisierungen
Kompatibilitätspolitik Der Master behält die Abwärtskompatibilität bei.
MediaWiki >= 1.41.0
Datenbankänderungen Ja
Composer mediawiki/babel
Tabellen babel
Lizenz GNU General Public License 2.0 oder neuer
Herunterladen Im Sprachenerweiterungsbündel enthalten
Beispiel Translatewiki.net
  • $wgBabelMainCategory
  • $wgBabelAutoCreate
  • $wgBabelDefaultLevel
  • $wgBabelCategorizeNamespaces
  • $wgBabelUseUserLanguage
  • $wgBabelCentralDb
  • $wgBabelCategoryNames
  • $wgBabelUseCommunityConfiguration
  • $wgBabelAllowOverride
Quarterly downloads 65 (Ranked 71st)
Public wikis using 2,416 (Ranked 192nd)
Übersetze die Babel-Erweiterung, wenn sie auf translatewiki.net verfügbar ist
Probleme Offene Aufgaben · Einen Fehler melden

Die Babel-Erweiterung fügt eine Parserfunktion hinzu, um das alte Babel-System zu ersetzen, welches vollständig auf Vorlagen angewiesen war. Falls ein nicht anerkannter Sprachparameter angegeben wird, wird es sehen, ob es eine vorhandene Vorlage mit den Namen gibt und dies einschließt.

In den Wikimedia-Projekten bezieht sich das Substantiv Babel (in Anlehnung an den Turm zu Babel) auf die Texte auf den Benutzerseiten, die die mehrsprachige Kommunikation unterstützen, indem sie die Kontaktaufnahme mit jemandem erleichtern, der eine bestimmte Sprache spricht. Die Idee stammt ursprünglich von Wikimedia Commons und wurde auch in vielen anderen Wikis umgesetzt.

Installation

  • Die Erweiterung herunterladen und die Datei(en) in ein Verzeichnis namens Babel im Ordner extensions/ ablegen.
    Entwickler und Code-Beitragende sollten stattdessen die Erweiterung von Git installieren, mit:cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/Babel
  • Folgenden Code am Ende deiner LocalSettings.php -Datei einfügen:
    wfLoadExtension( 'Babel' );
    
  • Führe das Aktualisierungsskript aus, welches automatisch die notwendigen Datenbanktabellen erstellt, die diese Erweiterung braucht.
  • Konfiguriere nach Bedarf.
  •   Erledigt – Navigiere zu Special:Version in deinem Wiki, um zu überprüfen, ob die Erweiterung erfolgreich installiert wurde.
  • Das CSS befindet sich in der Datei resources/ext.babel.css. Du kannst den Stil nach Belieben ändern, indem du ihn in der Seite MediaWiki:Common.css überschreiben.
  • Wenn die CLDR -Erweiterung gefunden wird, werden die Sprachnamen von dieser übernommen (wenn keine Übersetzungen verfügbar sind), ansonsten werden die eingebauten MediaWiki-Sprachnamen und die englischen Standardwerte verwendet.

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.

Um eine andere Vorlage einzuschließen, füge einfach den Namen der Vorlage hinzufügen, z.B. User CSS, wenn Template:User CSS</code hinzugefügt werden soll. Ein Prefix oder Suffix kann zum Vorlage-Namen hinzugefügt werden (z.B. User am Anfang). Dies kann genutzt werden, um die Auswahl einzuschränken und die Länge des Parameters zu reduzieren; zum Beispiel könnte CSS einschließen Template:User CSS, wenn auf diese Art konfiguriert.

Parameter

Zum Entfernen der Kopf- oder Fußzeile, kann plain=1 als erster Parameter verwendet werden, z.B. {{#babel: plain=1 | babelcode1 | babelcode2 | ... }}. Dadurch wird die Verwendung von Babel mit anderen Userboxen erleichtert.

To hide categories, use the nocat=1 parameter as the first parameter, e.g., {{#babel: nocat=1 | babelcode1 | babelcode2 | ... }}.

Bitte beachten, dass nur einer der obigen Parameter erlaubt ist. 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 categorize categories automatically, and if something happens, you can simultaneously replace the categorization and text in all categories.

Konfiguration

Konfigurationsparameter

Babel hat sechs Konfigurationsparameter, die in LocalSettings.php geändert werden können.

$wgBabelLanguageCodesCdb
(string) der Pfad der Sprachcode-Datenbankdatei; der Standardwert sollte ausreichen.
$wgBabelLanguageNamesCdb
(string) der Pfad der Sprachennamen-Datenbankdatei, der Standardwert sollte ausreichen.
$wgBabelCategoryNames
(Array aus String oder Boolean, indiziert durch die Strings "1", "2", ... "5", "N"), wobei jeder Eintrag der Name einer Kategorie für das durch seinen Index angegebene Fähigkeitsniveau ist, mögliche variable Elemente sind: %code% (Sprachcode), %wikiname% (der Name der Sprache in der Inhaltssprache des Wikis) und %nativename% (der Name der Sprache in seiner Sprache). Um das Hinzufügen einer Kategorie für eine bestimmte Stufe zu deaktivieren, setzen Sie den entsprechenden Wert auf false.
Zum Beispiel:
$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',
];
werden Kategorien wie "Category:User en-0" und "Category:User fr-N" verwendet. Die Standardeinstellung ist nur "Category:Fr-N" und so weiter.
$wgBabelMainCategory
(string) Name der Hauptkategorie (ohne Ebene) für jede Sprache, zu der alle Benutzer dieser Sprache hinzugefügt werden. Zum Deaktivieren auf false setzen; Standardwert ist das Format "Category:Fr". Es wird das gleiche Format wie $wgBabelCategoryNames oben akzeptiert. Beispiel:
$wgBabelMainCategory = 'User %code%';
$wgBabelDefaultLevel
(string) Standard-Fähigkeitsstufe, die verwendet werden soll, wenn keine angegeben wird, sollte ein Index von $wgBabelCategoryNames sein, der eine der Zeichenketten "1", "2", ... "5", "N" ist. Voreinstellung ist "N".
$wgBabelUseUserLanguage
( boolean ) Ob die Sprache der Benutzeroberfläche für die Kopf- und Fußzeile verwendet werden soll. Wenn false (Standard), wird die Sprache des Seiteninhalts verwendet. Dies liegt daran, dass die Verwendung der Sprache der Benutzeroberfläche den Parser-Cache fragmentieren kann.
$wgBabelCategorizeNamespaces
Namespace-Bereich, nur zum Hinzufügen der automatischen Kategorisierung. Zum Beispiel, wenn $wgBabelCategorizeNamespaces = [ NS_USER ]; dann wird Babel nur Kategorien zu Seiten im Benutzer-Namespace hinzufügen. Der Standard ist Null, was bedeutet jeder Namespace wird kategorisiert.
$wgBabelCategoryOverride
Ob Babel Kategorien erlaubt sind, in Wiki überschreiben zu werden durch Nutzung MediaWiki:Babel-category-override
$wgBabelAutoCreate
Ob Kategorien auto-erstellt werden.

Systemnachrichten

Verschiedene Anpassungen können auch über MediaWiki-Namensraummeldungen vorgenommen werden.

MediaWiki:babel-template "Template:User $1"
Das Format der Vorlagennamen, wenn eine Vorlage enthalten ist.
MediaWiki:babel-portal ""
Das Format des Ziels der Verknüpfung aus dem Sprachcode. Einen leeren String setzen, um nicht den Sprachcode zu verlinken.
MediaWiki:Babel-autocreate-user "Babel AutoCreate"
Benutzername, der für die automatische Erstellung von Babel-Kategorien verwendet werden soll
MediaWiki:babel-autocreate-text-levels "Benutzer in dieser Kategorie haben Kenntnisse der Stufe $1 in der Sprache $2."
Text, der in die automatisch erstellten Kategorien für die verschiedenen Sprachstufen eingefügt wird. Du musst dies ändern, wenn du möchtest, dass sie in der Hauptkategorie der jeweiligen Sprache ($wgBabelMainCategory) automatisch kategorisiert werden.
MediaWiki:babel-autocreate-text-main "Benutzer in dieser Kategorie haben Kenntnisse der Sprache $1."
Text, der in die automatisch erstellten Kategorien für Nicht-Ebenen-Kategorien eingefügt wird. Du musst dies ändern, wenn du möchtest, dass sie automatisch in einer übergeordneten Kategorie für alle Sprachen kategorisiert werden.
MediaWiki:babel "Babel – Benutzerinformationen"
Der Kopf der Babelbox - setzen um keinen Header anzuzeigen
MediaWiki:babel-url "Project:Babel"
Der Seitenname, unter dem Informationen über die babel-Erweiterung gefunden werden können - setzen, um keinen Link im Header anzuzeigen.
MediaWiki:Babel-footer "Benutzer nach Sprache"
Die Fußzeile der Babelbox - setzen um keinen Footer anzuzeigen.
MediaWiki:babel-footer-url " :Category:Babel - Benutzer nach Sprache"
Die Seite, zu der die Fußzeile der Babelbox verlinkt werden soll
MediaWiki:Babel-category-override "$1"
Überschreibt die automatisch generierten Babel-Kategorien. Parameters:
$1 = die Kategorie die normalerweise generiert wird.
$2 = der Sprach-Code
$3 = das Babel-Level.
Überschriebene Kategorien, die diese Methode nutzen, werden automatisch erstellt, um das Risiko von Vandalismus oder versehentlichen Änderungen dieser Seite zu reduzieren.

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]