Extension:Babel

Manuel des extensions MediaWiki

Babel État de la version : stable
Implémentation	Extension de l'analyseur
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+
Modifie la base de données	Oui
Composer	mediawiki/babel
Tables	babel
Licence	Licence publique générale GNU v2.0 ou supérieur
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 bogue

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, s'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' );
  

• Configurez selon les besoins.
•  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 les styles comme vous le souhaitez en les modifiant sur la page MediaWiki:Common.css.
• Si l'extension CLDR est trouvée, les noms de langues sont récupérés depuis celle-ci (quand les traductions ne sont pas disponibles), sinon les noms de langue proviennent de MediaWiki et les valeurs 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 du contenu écrit ou des questions simples dans cette langue.

xx-2 

compréhension intermédiaire - suffisante pour effectuer des modifications ou pour les discussions.

xx-3 

niveau avancé - bien que vous puissiez écrire dans cette langue sans problème, de petites erreurs peuvent être commises.

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 locutions.

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 

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

$wgBabelLanguageNamesCdb 

(chaîne de caractères) 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 chaînes de caractères ou de booléens, indexés par les chaînes de caractères «1 », « 2 », ... « 5 », « N ») tableau dont chaque entrée est le nom de la catégorie pour le niveau de compétences indiqué par son indice ; les éléments variables possibles sont : %code% (code de langue), %wikiname% (le nom de la langue dans la langue du contenu du wiki) et %nativename% (le nom de la langue dans cette langue). Pour désactiver l'ajout d'une catégorie pour un niveau particulier, fixer la valeur correspondante à 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 simplement « Category:Fr-N », et ainsi de suite.

$wgBabelMainCategory 

(chaîne de caractères) nom de la catégorie principale (qui ne correspond pas à un niveau de compétence) 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 

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

$wgBabelUseUserLanguage 

(booléen) indique 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 la valeur false est définie (c'est la valeur par défaut), la langue du contenu de la page sera utilisée. Cela vient du fait qu'utiliser la langue de l'interface utilisateur peut fragmenter le cache de l'analyseur syntaxique.

Messages 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 d'après 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 relatives à 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 correspondante ($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 boîte Babel

MediaWiki:babel-url "Project:Babel"

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

MediaWiki:Babel-footer "Utilisateurs par langue"

Le pied de page de la boîte Babel

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

La page à lier au pied de page de la boîte 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]