Extension:Babel/fr

Category:GPL licensed extensions/fr
Manuel des extensions MediaWiki
Babel
État de la version : stableCategory:Stable extensions/fr
Implémentation Fonction d'analyseur Category:Parser function extensions/fr
Description Ajoute une fonction d'analyse syntaxique 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 (RobertLdiscussion)
Dernière version Mises à jour continues
Politique de compatibilité Le master conserve la compatibilité arrière.
MediaWiki >= 1.43.0
Modifie la base
de données
Oui
Composer mediawiki/babelCategory:Extensions supporting Composer/fr
Tables babel
Licence Licence publique générale GNU v2.0 ou supérieur
Téléchargement Inclus dans le paquet Language Extension (MLEB) Category:Extensions in Wikimedia version control/fr
Exemple Translatewiki.net
  • $wgBabelMainCategory
  • $wgBabelAutoCreate
  • $wgBabelAllowOverride
  • $wgBabelCategorizeNamespaces
  • $wgBabelUseUserLanguage
  • $wgBabelCentralDb
  • $wgBabelCategoryNames
  • $wgBabelUseCommunityConfiguration
  • $wgBabelDefaultLevel
Traduire l’extension Babel sur translatewiki.net si elle y est disponible
Problèmes Tâches ouvertes · Signaler un bogue
Category:All extensions/fr

L’extension Babel ajoute une fonction d'analyse syntaxique pour remplacer l’ancien système Babel qui reposait entièrement sur des modèles. Si un paramètre de langue non reconnue est spécifié, l'extension cherchera un modèle existant avec le nom et l'incluera. This information can then additionally be stored via categories, allowing others to find users who speak any particular language.

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.

The Babel extension still makes use of templates: if an unrecognized language parameter is specified, the extension will see if there is an existing template with that name and include that if so.

Installation

  • Téléchargez et placez le(s) fichier(s) dans un répertoire appelé Babel dans votre dossier extensions/.
    Les développeurs et les contributeurs au code doivent à la place installer l'extension à partir de Git en utilisant:
    cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/Babel
    
  • Ajoutez le code suivant à la fin de votre fichier LocalSettings.php  :
    wfLoadExtension( 'Babel' );
    
  • Exécutez le script de mise à jour qui va créer automatiquement les tables de base de données dont cette extension a besoin.
  • Configurez selon les besoins.
  • Yes Fait – Accédez à Special:Version sur votre wiki pour vérifier que l'extension a bien été installée.
  • Le CSS est situé dans le fichier resources/ext.babel.less. Vous pouvez changer les styles comme vous le souhaitez en les modifiant sur la page MediaWiki:Common.css.
  • Si l'extension CLDR/fr 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ées.

Utilisation

Syntaxe pour la fonction d'analyse #babel :

{{#babel: codebabel1 | codebabel2 | ... }}

Ajouter l'un des codes suivants pour chaque langue que vous parlez ou que vous comprenez, séparé par |, où xx est le code de langue de MediaWiki, le code ISO 639-1 ou le code 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 du tout la langue.
xx-1
compréhension basique — suffisante pour comprendre le 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 CSS utilisateur si vous voulez inclure Modèle:CSS utilisateur. Un préfixe ou un suffixe peuvent être ajoutés aux noms du modèle (par exemple CSS au début) en fonction de votre configuration locale. Ceci peut être utilisé pour restreindre la sélection et réduire la longueur des paramètres ; par exemple utilisateur pourrait inclure Modèle:CSS utilisateur si vous le configurez de cette manière. 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, CSS could include Template:User CSS if configured in such a way.

For example in the mentioned case of CSS (Cascading Style Sheets), it might collide with the ISO code for Southern Ohlone language. In such case, to enforce the usage of a local template, simply prefix the parameter with an underscore (_), e.g. … html-3|_css-2|js-1 ….

Paramètres

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

Pour masquer les catégories, utilisez le paramètre nocat=1 comme premier paramètre, par exemple {{#babel: nocat=1 | codebabel1 | codebabel2 | ... }}.

Veuillez noter qu'un seul des paramètres ci-dessus est autorisé. Pour l'instant, il n'est pas possible d'utiliser les deux paramètres à la fois. Par exemple, {{#babel: nocat=1 | plain=1 | codebabel1 | codebabel2 | ... }} ne fonctionnera pas.

Catégorisation

Si la catégorisation est activée, l'extension crée des catégories via le robot Babel AutoCreate avec le texte spécifié dans MediaWiki:babel-autocreate-text-levels et MediaWiki:babel-autocreate-text-main. Avec les paramètres de base, les catégories créées par le robot ne sont pas catégorisées. Pour y remédier, il est recommandé de procéder comme suit :

  1. Créez un modèle {{Babel category }} qui générera des catégories.
  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}}
    

Cela vous permettra de catégoriser automatiquement les catégories. Et si quelque chose se produit, vous pouvez simultanément remplacer la catégorisation et le texte dans toutes les catégories.

Configuration

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étence indiqué par son indice ; les éléments variables possibles sont : %code% (code de langue), %wikiname% (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'aucune valeur n'est spécifiée, doit être un indice de $wgBabelCategoryNames, c'est à dire 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 le pied de page.

S'il vaut false (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.

$wgBabelCategorizeNamespaces
Tableau d'espaces de noms pour lesquels il faut ajouter la catégorisation automatique. Par exemple s'il vaut $wgBabelCategorizeNamespaces = [ NS_USER ];, alors Babel n'ajoutera les catégories qu'aux pages de l'espace de noms User:. La valeur par défaut est null, ce qui signifie qu'il faut catégoriser tous les espaces de noms.
$wgBabelCategoryOverride
Indique s'il est permis de réécrire les catégories Babel sur le wiki en utilisant MediaWiki:Babel-category-override
$wgBabelAutoCreate
Indique s'il faut créer les catégories automatiquement.

Messages système

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

MediaWiki:babel-template "Template:User $1"
Le format des noms de modèles lorsque l'un d'eux est inclus.
MediaWiki:babel-portal ""
Le format de la cible du lien d'après le code de langue. Laisser vide pour ne pas lier 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. $4"
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é qu'ils connaissaient la langue $1. $3"
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·ice"
Entête de la boîte Babel Mettre à - pour masquer l'entête.
MediaWiki:babel-url "Project:Babel"
Nom de la page où l'information sur l'extension Babel peut être consultée Mettre à - pour ne pas faire figurer de lien dans l'entête.
MediaWiki:Babel-footer "Utilisateurs par langue"
Pied de page de la boîte Babel Mettre à - pour masquer le pied de page.
MediaWiki:babel-footer-url " :Catégorie:Babel – Utilisateurs par langue"
Page à lier au pied de page de la boîte Babel
MediaWiki:Babel-category-override "$1"
Supplante toute catégorie Babel générée automatiquement. Paramètres :
$1 = catégorie à générer normalement.
$2 = code de langue
$3 = niveau de babel.
Toute catégorie redéfinie en utilisant cette méthode ne sera pas créée automatiquement, afin de réduire le risque de vandalisme et les modifications par erreur apportées à cette page.

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]
Category:Extensions used on Wikimedia/fr#Babel/fr Category:Localisation extensions/fr
Category:All extensions/fr Category:CommunityConfigurationProvider initList extensions/fr Category:Extensions in Wikimedia version control/fr Category:Extensions included in Canasta/fr Category:Extensions included in Miraheze/fr Category:Extensions included in ShoutWiki/fr Category:Extensions included in WikiForge/fr Category:Extensions included in wiki.gg/fr Category:Extensions supporting Composer/fr Category:Extensions used on Wikimedia/fr Category:GPL licensed extensions/fr Category:LinksUpdate extensions/fr Category:LoadExtensionSchemaUpdates extensions/fr Category:Localisation extensions/fr Category:ParserFirstCallInit extensions/fr Category:Parser function extensions/fr Category:Stable extensions/fr Category:UserGetReservedNames extensions/fr