Extension:CLDR/fr

From mediawiki.org
This page is a translated version of the page Extension:CLDR and the translation is 100% complete.
Manuel des extensions MediaWiki
CLDR
État de la version : stable
Implémentation Fonction d'analyseur
Description Fournit les fonctions permettant de traduire les noms des langues, des pays, des monnaies, et des unités de temps en fonction de leur code de langue.
Auteur(s)
Dernière version 4.14.0 (Mises à jour continues)
MediaWiki 1.30+
Modifie la base
de données
Non
Composer mediawiki/cldr
Licence GPL-2.0-or-later, data variant of BSD 3-clauses
Téléchargement Inclus dans le paquet de l'extension Language ou
README
Exemple Translatewiki.net
master
Utilisé par les wikis publics 6,625 (Ranked 63rd)
Traduire l’extension CLDR sur translatewiki.net si elle y est disponible

L'extension CLDR contient les noms de langues locaux de différentes langues, pays, monnaies, et unités de temps extraits des données CLDR. Voir translatewiki:CLDR pour plus d'informations.


Installation

  • Téléchargez et placez le(s) fichier(s) dans un répertoire appelé cldr 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/cldr
  • Ajoutez le code suivant à la fin de votre fichier LocalSettings.php  :
    wfLoadExtension( 'cldr' );
    
  • Yes Fait – Accédez à Special:Version sur votre wiki pour vérifier que l'extension a bien été installée.

Si vous téléchargez à partir de Git, changez le nom de fichier de CLDR en cldr.

Mise à jour des données

L'extension CLDR est fournie avec des données pré-populées dans les fichiers de langue, mais si vous souhaitez obtenir les dernières données du Consortium Unicode, vous devez les télécharger du site CLDR et ensuite exécuter un script de reconstruction.

Télécharger les dernières informations du site CLDR :

http://www.unicode.org/cldr/repository_access.html

Exemple (extrait du répertoire cldr) :

wget http://www.unicode.org/Public/cldr/latest/core.zip
unzip core.zip -d core
php rebuild.php

Utilisation et paramètres

Noms des langues

CLDR définit la classe LanguageNames qui comporte une méthode statique getNames(). LanguageNames::getNames accepte trois paramètres :

  1. code - code ISO 639 (voir les Codes de langue pour les détails) de la langue favorite dans laquelle renvoyer la liste
  2. fbMethod - méthode de repli, doit être initialisée à l'une des valeurs suivantes :
    • LanguageNames::FALLBACK_NATIVE - Les entrées manquantes seront repliées vers le nom natif (par défaut)
    • LanguageNames::FALLBACK_NORMAL - Les entrées manquantes sont repliées conformément au mécanisme de repli
  3. list - langues à renvoyer. Doit être initialisé à l'une des valeurs suivantes :
    • LanguageNames::LIST_MW_SUPPORTED - Uniquement les langues traduites dans MediaWiki
    • LanguageNames::LIST_MW - Toutes les langues qui sont dans Names.php (par défaut)
    • LanguageNames::LIST_MW_AND_CLDR - Toutes les langues qui sont soit dans MediaWiki ou dans CLDR

Exemple

L'accès aux noms des langues se fait facilement à l'aide des fonctions du noyau MediaWiki :

// Japanisch
$name = Language::fetchLanguageName( 'ja', 'de', 'all' );

Noms des pays

CLDR définit la classe CountryNames qui possède une méthode getNames(). CountryNames::getNames n'accepte qu'un paramètre :

  1. code - code ISO 639 de la langue favorite dans laquelle renvoyer la liste

Exemple

L'exemple suivant définit une variable de la liste de l'ensemble des pays de CLDR en français.

if ( is_callable( array( 'CountryNames', 'getNames' ) ) ) {
    $countries = CountryNames::getNames( 'fr' );
}


Voir aussi