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.

GroupeContenuModèle de sortie documenté
json, json5, jsoncVariantes de JSON structuréFichiers distincts par langue
json-dictionaryValeurs JSON contenant des objets indexés par langueFichier partagé
yamlCatalogue YAMLFichiers distincts par langue
yaml-root-keyYAML placé sous la clé racine de la langue de sortieFichiers distincts par langue
markdown, mdx, markdocDocuments de la famille MarkdownFichiers distincts par langue
html, mjmlBalisage HTML et d’e-mailsFichiers distincts par langue
androidRessources XML AndroidFichiers distincts par langue
xcode-strings, xcode-stringsdictRessources Apple pour les chaînes et les plurielsFichiers distincts par langue
xcode-xcstringsCatalogue de chaînes XcodeFichier partagé
flutterCatalogue ARBFichiers distincts par langue
poPO GettextFichiers distincts par langue
propertiesPropriétés JavaFichiers distincts par langue
csvCSV multilingueFichier partagé
csv-per-localeUn CSV par langueFichiers distincts par langue
xml, xliffXML et XLIFFFichiers distincts par langue
srt, vttSous-titresFichiers distincts par langue
phpTableaux de localisation PHPFichiers distincts par langue
typescriptContenu de localisation TypeScriptFichiers distincts par langue
vue-jsonBlocs JSON Vue i18n indexés par langueFichier partagé
txtTexte brutFichiers 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 :

json
{
  "buckets": {
    "json": { "include": ["src/locales/[locale].json"] }
  }
}

Pour un catalogue Xcode partagé associé à des ressources Android propres à chaque langue :

json
{
  "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é :

json
{
  "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.