Jump to content

Manuel:GenerateJsonI18n.php

From mediawiki.org
This page is a translated version of the page Manual:GenerateJsonI18n.php and the translation is 100% complete.

Détails

Version de MediaWiki :
1.23
Gerrit change 102171

Le fichier generateJsonI18n.php est un script de maintenance qui génère les fichiers i18n au format JSON à partir des anciens fichiers i18n MediaWiki basés sur les tableaux PHP.

Utilisation

php maintenance/generateJsonI18n.php phpfile jsondir

où :

  • phpfile - fichier PHP définissant un tableau $messages. Nécessaire sauf si --extension est fourni.
  • jsondir - répertoire pour stocker les fichiers JSON. Par défaut : $phpfile/i18n.

Paramètres dépendants du script

Option/paramètre Description
--langcode="lang" Code de langue; nécessaire seulement pour convertir les fichiers i18n du noyau.
--extension 1.24 Réalise la conversion par défaut sur une extension. Si vous utilisez ce paramètre, ne mettez pas l'argument phpfile . Cela fera que phpfile sera fixé à "$IP/extensions/$extension/$extension.i18n.php", et targetfolder à i18n.
--shim-only Crée ou met à jour uniquement le convertisseur de compatibilité arrière.
--supplementary Trouver les fichiers i18n supplémentaires dans les sous-répertoires et les convertir

Exemple

cd core/extensions/YourExtension
mkdir i18n
php ../../maintenance/generateJsonI18n.php ExtensionName.i18n.php i18n
Version de MediaWiki :
1.24
Gerrit change 122659

Manière alternative pour les extensions, depuis Gerrit change 122659: cet exemple réalise les conversions par défaut dans $IP/extensions/WikiLove/, en remplaçant le fichier WikiLove.i18n.php à l'aide d'un convertisseur (shim) de compatibilté arrière et en portant les messages dans le répertoire WikiLove/i18n/.

php maintenance/generateJsonI18n.php --extension WikiLove

Processus de migration suggéré

Si votre extension n'a pas encore été convertie.

  • Assurez-vous d'avoir le dernier code
  • Créez le répertoire i18n
  • Exécutez le script
  • Mettez à jour le fichier de votre entrée d'extension en ajoutant $wgMessagesDirs ['YourExtension'] = __DIR__ . '/i18n';
  • Validez-le dans Gerrit si l'extension y est hébergée
  • Ajoutez les utilisateurs Siebrand et Raimond comme relecteurs si l'extension est traduite via translatewiki.net
  • Attendez la relecture et tout devrait se passer correctement

Voir aussi