Formats de la CLI v0
Associez l’ancien analyseur installé à l’organisation de ses fichiers par langue et vérifiez le fichier natif reconstruit.
Choisissez le groupe en fonction des données à extraire et des fichiers attendus en sortie. La v0 sélectionne l’analyseur selon le type du groupe ; l’extension ne modifie pas ce choix. Un catalogue JSON et un catalogue Xcode multilingue nécessitent donc des configurations différentes, même s’ils contiennent tous deux des messages.
Choisissez d’abord le modèle de sortie #
La plupart des groupes écrivent des fichiers distincts par langue en utilisant [locale] dans le chemin. Les fichiers CSV, les catalogues de chaînes Xcode, les dictionnaires JSON et les blocs Vue i18n peuvent contenir plusieurs langues dans un même fichier. Pour une sortie partagée, vérifiez la section cible comme la section source après la traduction.
| Groupe | Contenu | Modèle de sortie documenté |
|---|---|---|
json, json5, jsonc | Variantes de JSON structuré | Fichiers distincts par langue |
json-dictionary | Valeurs JSON contenant des objets indexés par langue | Fichier partagé |
yaml | Catalogue YAML | Fichiers distincts par langue |
yaml-root-key | YAML placé sous la clé racine de la langue de sortie | Fichiers distincts par langue |
markdown, mdx, markdoc | Documents de la famille Markdown | Fichiers distincts par langue |
html, mjml | Balisage HTML et d’e-mails | Fichiers distincts par langue |
android | Ressources XML Android | Fichiers distincts par langue |
xcode-strings, xcode-stringsdict | Ressources Apple pour les chaînes et les pluriels | Fichiers distincts par langue |
xcode-xcstrings | Catalogue de chaînes Xcode | Fichier partagé |
flutter | Catalogue ARB | Fichiers distincts par langue |
po | PO Gettext | Fichiers distincts par langue |
properties | Propriétés Java | Fichiers distincts par langue |
csv | CSV multilingue | Fichier partagé |
csv-per-locale | Un CSV par langue | Fichiers distincts par langue |
xml, xliff | XML et XLIFF | Fichiers distincts par langue |
srt, vtt | Sous-titres | Fichiers distincts par langue |
php | Tableaux de localisation PHP | Fichiers distincts par langue |
typescript | Contenu de localisation TypeScript | Fichiers distincts par langue |
vue-json | Blocs JSON Vue i18n indexés par langue | Fichier partagé |
txt | Texte brut | Fichiers distincts par langue |
Il s’agit de l’ancienne famille de groupes, et non d’une liste de compatibilité avec d’autres outils. Certaines entrées peuvent avoir été ajoutées après les premières versions de la v0. Les analyseurs TypeScript, PHP et Vue traitent les structures de localisation qu’ils prennent en charge ; leur présence ne permet pas de réécrire arbitrairement du code source exécutable.
Le répartiteur 0.138.10 contient également ail, ejs, twig, dato et xcode-xcstrings-v2. Conservez l’analyseur déjà utilisé par un projet installé tant que vous n’avez pas examiné ses entrées et ses sorties. Une énumération dans le schéma ne suffit pas : l’ancien schéma mentionne aussi compiler, mais aucun chargeur correspondant n’existe dans ce circuit de répartition.
yaml-root-key reconstruit uniquement la racine de la langue sélectionnée. Ne faites pas pointer la source et la cible vers le même fichier YAML partagé : une écriture peut remplacer les autres racines du fichier. Utilisez un chemin propre à la langue, comme locales/[locale].yml. Ce comportement diffère de celui d’un dictionnaire JSON ou d’un bloc Vue, qui intègre explicitement une nouvelle langue à la structure d’origine par fusion.
Configurez un fichier représentatif #
Pour JSON, le même motif désigne un fichier source et des cibles distinctes :
{
"buckets": {
"json": { "include": ["src/locales/[locale].json"] }
}
}Pour un catalogue Xcode partagé associé à des ressources Android propres à chaque langue :
{
"buckets": {
"xcode-xcstrings": { "include": ["ios/Localizable.xcstrings"] },
"android": {
"include": ["android/app/src/main/res/values-[locale]/strings.xml"]
}
}
}Adaptez la notation des langues Android et les répertoires de ressources à l’application. Après la première exécution, validez les deux formats natifs avec leurs outils de compilation et vérifiez que l’application charge la cible sélectionnée. Le seul fait que la configuration soit acceptée ne garantit pas que le chemin fonctionne.
Repérez les fichiers sans sélectionner les sorties générées #
Les chemins sont résolus par rapport à i18n.json ; * recherche les correspondances sur un seul niveau. La prise en charge de ** en mode récursif a été introduite dans 0.135.0. Elle exclut par défaut node_modules, .git, dist, build, .next et .turbo. Excluez explicitement tout autre contenu généré :
{
"buckets": {
"markdown": {
"include": ["docs/[locale]/*.md"],
"exclude": ["docs/[locale]/drafts/*.md"]
}
}
}Pour plusieurs paquets, choisissez une configuration partagée ou par paquet selon les langues et la responsabilité du moteur de localisation. Des chemins bien délimités évitent que les sorties générées ne soient utilisées comme entrées source par inadvertance.
Vérifiez les protections propres à chaque format #
Pour les catalogues clé/valeur, appliquez les contrôles des clés selon la responsabilité de chaque valeur. Les commentaires des catalogues JSONC et Xcode peuvent contenir des notes à l’intention des traducteurs. Les documents à structure libre et les sous-titres n’utilisent pas nécessairement ces fonctionnalités de la même manière.
Examinez ce que l’analyseur a reconstruit : les clés et les valeurs du catalogue, le balisage et les liens du document, les repères temporels des sous-titres ou les identifiants des ressources natives. N’acceptez la sortie qu’après avoir vérifié que l’analyseur ou le processus de compilation qui l’utilise peut la traiter. Lors d’une migration, consultez le manuel des formats actuel et la liste des formats pris en charge par l’outil appelant, plutôt que de supposer que cette ancienne matrice reste applicable.