CLI v0 : gestion des clés et modifications manuelles
Distinguez les valeurs pilotées par la source, les traductions gérées manuellement et les corrections courantes dans les anciens catalogues.
Une correction manuelle courante et une clé préservée n’ont pas la même durée de vie. La v0 conserve normalement une valeur cible existante tant que sa source reste inchangée. Une clé préservée réserve la gestion de sa valeur à une personne, même lorsque le texte source change.
Corriger une traduction courante #
Modifiez directement la valeur cible et committez la formulation retenue. Si la source reste inchangée, le delta habituel peut la conserver. Une modification de la somme de contrôle de la source rend cette clé à nouveau éligible à la traduction, et le mode forcé peut la remplacer même si la source reste inchangée.
Utilisez cette méthode pour une correction dont le sens doit être réexaminé lorsque la source change. Pour le contenu qui doit rester sous gestion humaine, choisissez la préservation et prévoyez un processus de relecture des modifications de la source.
Définir explicitement qui gère chaque valeur #
| Contrôle | Comportement de sortie de l’ancienne version |
|---|---|
lockedKeys | Copier la valeur source ; cette opération peut écraser une modification de la valeur cible. |
ignoredKeys | Exclure le contenu sélectionné de la traduction et de la sortie. |
preservedKeys | Initialiser une valeur manquante à partir de la source, puis conserver la valeur cible pour permettre sa gestion manuelle. |
{
"buckets": {
"json": {
"include": ["locales/[locale].json"],
"lockedKeys": ["brand/name"],
"ignoredKeys": ["internal/*"],
"preservedKeys": ["legal/terms"]
}
}
}Ici, le nom de marque reste identique, les entrées internes disparaissent et les termes juridiques restent sous gestion humaine. Un texte provisoire dans la langue source qui vient d’être préservé doit encore être traduit avant la publication. Si l’application attend une clé ignorée, prévoyez une solution de repli ou modifiez cette exigence.
Examinez les motifs de contrôle qui se chevauchent plutôt que de présumer un ordre de priorité non documenté. Ce comportement de la v0 diffère des contrôles actuels de préservation des valeurs cibles.
Cibler les clés imbriquées et littérales #
Les anciens chemins utilisent des barres obliques pour parcourir la structure. brand/name sélectionne name dans brand ; modules/ai.translation sélectionne une clé littérale contenant des points dans modules. Les caractères génériques suivent l’ancien mécanisme de correspondance et doivent être testés à la profondeur prévue. La syntaxe actuelle utilisant des points et des crochets n’est pas interchangeable avec l’ancienne.
Réutiliser une traduction lors d’un renommage #
L’ancien delta peut faire correspondre l’empreinte de la valeur source d’une nouvelle clé à l’empreinte précédente d’une clé supprimée, dans le même contexte de chemin traité. Si le texte reste identique, une valeur cible existante peut être transférée à la clé renommée sans nouvelle traduction.
Modifier à la fois la clé et la source crée du travail supplémentaire. Un déplacement entre des chemins indépendants ou l’utilisation de chaînes identiques répétées demande une vérification ; ce mécanisme de correspondance ne constitue pas une mémoire de traduction utilisable sans restriction. Les identités JSON actuelles reposent sur les chemins et n’héritent pas de ce comportement.
Utilisez Retraduction pour remplacer volontairement une traduction et Notes de traduction pour fournir des indications contextuelles. Aucune de ces options ne remplace la nécessité de définir qui gère une valeur de sortie.