Extension:Babel

Manuel des extensions MediaWiki

Babel État de la version : stable
Implémentation	Parser extension
Description	Ajoute une fonction parseur pour informer les autres utilisateurs de son niveau de maîtrise d’une langue et catégorise les utilisateurs par niveau et par langue.
Auteur(s)	Robert Leverington (RobertLtalk)
Dernière version	Continuous updates
MediaWiki	1.30+
Changements base de données	Oui
Composer	mediawiki/babel
Tables	babel
Licence	GNU General Public License 2.0 or later
Téléchargement	Inclus dans le paquet Language Extension (MLEB) Télécharger l'extension Git [?]: Télécharger la branche master de Git parcourir le dépôt (GitHub) historique des validations (commits) relecture du code
Exemple	Translatewiki.net
Paramètres $wgBabelCategorizeNamespaces $wgBabelCategoryNames $wgBabelMainCategory $wgBabelDefaultLevel $wgBabelUseUserLanguage $wgBabelUseDatabase $wgBabelCentralDb $wgBabelCentralApi
Accroches utilisées ParserFirstCallInit LinksUpdate LoadExtensionSchemaUpdates UserGetReservedNames
Traduisez l’extension Babel sur translatewiki.net
Vérifiez la matrice des utilisations et des versions.
Problèmes	Tâches ouvertes · Signalez un bug

L’extension Babel ajoute une fonction parseur pour remplacer l’ancien système Babel qui reposait entièrement sur des modèles. Si un paramètre de langue n’est pas reconnu, l'extension cherchera le modèle Babel de la langue et l'affichera si il existe.

Sur les projets Wikimedia, le nom Babel (en référence à la Tour de Babel) fait référence aux textes sur les pages utilisateur qui facilitent la communication multilingue en simplifiant le contact des personnes qui parlent certaines langues. L’idée provient de Wikimedia Commons et elle a également été implémentée sur de nombreux autres wikis.

Téléchargement

Cette extension peut être récupérée directement depuis Git ^[?]:

• Naviguer dans le code
• Certaines extensions étiquettent les versions stables.
  • Naviguer dans les Étiquettes
  • Sélectionner l'étiquette
  • Cliquer sur snapshot (instantané)
• Chaque branche correspond à une version antérieure de MediaWiki. Il y a aussi une branche master (maître) qui contient la dernière version alpha (elle peut nécessiter une version alpha de MediaWiki)
  • Naviguer dans les branches
  • Sélectionnez le nom d'une branche
  • Cliquez sur Continue (continuer)

Décompressez l'instantané et placez-le dans le répertoire extensions/Babel/ de votre installation MediaWiki.

Si vous êtes familier de Git et si vous avez un accès au shell de votre serveur, vous pouvez aussi obtenir l'extension de la manière suivante:

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

Installation

• Téléchargez et placez le(s) fichiers (s) dans un répertoire appelé Babel dans votre dossier extensions/.

• Ajoutez le code suivant à la fin de votre fichier LocalSettings.php :

  wfLoadExtension( 'Babel' );
  

• Configure as required.
•  Fait – Accédez à Special:Version sur votre wiki pour vérifier que l'extension a bien été installée.

Pour les utilisateurs de MediaWiki 1.25 ou précédents :

Les instructions ci-dessus décrivent la nouvelle procédure pour installer cette extension en utilisant wfLoadExtension(). Si vous avez besoin d'installer cette extension sur les précédentes versions de MediaWiki (1.25 ou antérieur), à la place de wfLoadExtension( 'Babel' );, vous devez utiliser :

require_once "$IP/extensions/Babel/Babel.php";

• Le CSS est situé dans le fichier resources/ext.babel.css. Vous pouvez modifier le style comme vous le souhaitez en les modifiant dans la page MediaWiki:Common.css.
• Si l'extension CLDR est trouvée, les noms de langues sont récupérés depuis celle-ci (où les traductions ne sont pas disponibles), sinon les noms de langue proviennent de MediaWiki et les noms par défaut en anglais sont utilisés.

Utilisation

La syntaxe pour la fonction d'analyse #babel se présente comme ceci :

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

Ajouter l'un des codes suivants pour chaque langue que vous parlez ou comprenez, séparé par |, où xx est le code de langue de MediaWiki, le code ISO 639-1 ou le ISO 639-3 de la langue. L'utilisation générale de chaque niveau de code se présente comme ceci :

xx-0 

si vous ne comprenez pas la langue du tout.

xx-1 

compréhension basique - suffisante pour comprendre le matériel écrit ou les questions simples dans cette langue.

xx-2 

compréhension intermédiaire - suffisante pour modifier ou pour les discussions.

xx-3 

niveau avancé - bien que vous puissiez écire dans cette langue sans problème, de petites erreurs peuvent apparaitre.

xx-4

niveau « quasi-natif » - Bien qu'il ne s'agisse pas de votre langue maternelle, votre compréhension est similaire à celle d'un locuteur natif.

xx-5 

compétence professionnelle.

xx ou xx-N 

locuteur natif qui utilise la langue tous les jours et qui a une compréhension parfaite de celle-ci, y compris des expressions familières et des idiotimes.

Pour inclure d'autres modèles, ajoutez simplement le nom du modèle, par exemple ajouter Utilisateur de Paris si vous voulez inclure Modèle:Utilisateur de Paris. Un préfixe ou suffixe peut être ajouté aux noms de modèle (par exemple Utilisateur au début) dépendant de votre configuration locale, cela peut être utilisé pour restreindre la sélection et réduire la longueur des paramètres ; par exemple de Paris pourrait inclure Modèle:Utilisateur de Paris si vous le configurez de cette manière.

Pour enlever l'en-tête et le pied de page, utiliser plain=1 comme premier paramètre, par exemple {{#babel: plain=1 | babelcode1 | babelcode2 | ... }}. Ceci rend plus facile l'utilisation de Babel avec les autres boîtes utilisateur.

Paramètres de configuration

Babel dispose de six paramètres de configuration qui peuvent être modifiés depuis LocalSettings.php .

$wgBabelLanguageCodesCdb 

(chaine de caractères) le chemin où se trouve le fichier de la base de données des codes de langue, la valeur par défaut devrait suffire.

$wgBabelLanguageNamesCdb 

(chaine de caractères) le chemin où se trouve le fichier de la base de données des noms de langue, la valeur par défaut devrait suffire.

$wgBabelCategoryNames

(tableau de chaines de caractères ou de booléens, indexés par les chaines de caractères «1 », « 2 », ... « 5 », « N ») où chaque entrée est le nom de la catégorie pour le niveau de compétences indiqué par son indice, les éléments de variable possible sont : %code% (code de langue), %wikiname% (le nom de la langue dans la langue de contenu du wiki) et %nativename% (le nom de la langue dans cette langue). Pour désactiver l'ajout d'un catégorie pour un niveau particulier, fixer la valeur correspondant à « false ».

Par exemple :

$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',
];

utilisera des catégories comme « Category:User en-0 » et « Category:User fr-N ». La catégorie par défaut est juste « Category:Fr-N » et ainsi de suite.

$wgBabelMainCategory 

(chaine de caractères) Nom de la catégorie principale (qui n'est pas un niveau) pour chaque langue, dans laquelle tous les utilisateurs d'une langue sont ajoutés. Fixer la valeur à « false » pour le désactiver ; par défaut cela formate en « Catégorie:Fr ». Il accepte le même format que $wgBabelCategoryNames ci-dessus. Exemple :

$wgBabelMainCategory = 'User %code%';

$wgBabelDefaultLevel 

(chaine de caractères) Niveau de compétence par défaut à utiliser lorsqu'aucun n'est spécifié, ça devrait être un indice de $wgBabelCategoryNames, ce qui est l'une des chaines de caractères « 1 », « 2 », ..., « 5 », « N ». La valeur par défaut est « N ».

$wgBabelUseUserLanguage 

(booléen) Si on doit utiliser ou non la langue de l'interface utilisateur pour le message d'en-tête et de pied de page. Si « false » est choisi (par défaut), il sera la langue du contenu de la page. Cela vient du fait qu'utiliser la langue de l'interface utilisateur peut fragmenter le cache du parseur.

Messages de système

Plusieurs paramétrages peuvent aussi être faits en utilisant les messages de l'espace de nom MediaWiki.

MediaWiki:babel-template "Modèle:User $1"

Le format des noms de modèles lorsque l'un d'eux est inclus.

MediaWiki:babel-portal "⧼babel-portal⧽"

Le format de la cible du lien vers le code de langue.

MediaWiki:Babel-autocreate-user "Babel AutoCreate"

Le nom d'utilisateur qui doit être utilisé pour la création automatique des catégories reliées à Babel.

MediaWiki:babel-autocreate-text-levels "Les utilisateurs dans cette catégorie ont indiqué qu’ils ont le niveau $1 pour la langue $2."

Le texte à insérer dans les catégories créées automatiquement pour les différents niveaux de langue. Vous devez modifier cela si vous voulez qu'elles soient catégorisées automatiquement dans la catégorie principale de la langue respective ($wgBabelMainCategory).

MediaWiki:babel-autocreate-text-main "Les utilisateurs dans cette catégorie ont indiqué leur connaissance de la langue $1."

Le texte à insérer dans les catégories créées automatiquement pour les catégories non relatives aux niveaux. Vous devez modifier cela si vous voulez qu'elles soient catégorisées automatiquement dans la catégorie parente pour toutes les langues.

MediaWiki:babel "Informations Babel sur l’utilisateur"

L'en-tête de la boite Babel

MediaWiki:babel-url "Project:Babel"

Le nom de la page où l'information sur l'extension Babel peut être trouvée

MediaWiki:Babel-footer "Utilisateurs par langue"

Le pied de page de la boite Babel

MediaWiki:babel-footer-url " :Catégorie:Babel – Utilisateurs par langue"

La page à lier au pied de page de la boite Babel

meta=babel (bab)

(main | query | babel)

• This module requires read rights.
• Source: Babel
• License: GPL-2.0-or-later

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]