Manuel:GenerateJsonI18n.php
Fichier MediaWiki : generateJsonI18n.php | |
---|---|
Emplacement : | maintenance/ |
Code source : | master • 1.42.1 • 1.41.2 • 1.39.8 |
Classes : | GenerateJsonI18n |
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
- Demande de commentaire/Format de localisation (RFC) pour le contexte