Mettre à jour une clé ou un terme en toute sécurité
Retraduisez une partie ciblée, préservez le contenu voisin et vérifiez aussi bien la correction souhaitée que le contenu resté inchangé.
Une correction ciblée est réussie lorsque deux conditions sont réunies : le contenu sélectionné s’améliore et le contenu déjà accepté, sans rapport avec la correction, reste intact. Conservez la version cible existante et la révision de sa source pour vérifier ces deux points.
Utilisez ce guide pour une clé ou un terme identifié. Pour les modifications courantes de la source, consultez la préservation lors des mises à jour. Si le travail a déjà été soumis, vérifiez son état de récupération avant d’en demander davantage.
Inclure un élément voisin accepté dans la comparaison #
À titre d’exemple, un catalogue pourrait contenir :
{
"account": {
"invitation": "Approval is required before access is granted.",
"support": "Contact support"
}
}Supposons que seule la formulation cible de account.invitation doive être corrigée. Enregistrez la version cible et la révision de la source, en incluant la formulation acceptée de account.support que vous souhaitez conserver.
Choisir comment corriger la formulation #
Pour une correction ponctuelle précise, modifiez directement la valeur cible, vérifiez-la dans l’application, puis committez le catalogue relu. Les mises à jour courantes de la source peuvent conserver cette modification tant que la source du message reste inchangée.
Pour régénérer le contenu, fournissez d’abord au processus de traduction les informations nécessaires pour obtenir un résultat différent. Ajoutez un terme approuvé au glossaire du moteur, corrigez une instruction récurrente dans ses règles ou clarifiez le contexte JSONC d’un message. Actualisez ensuite les clés concernées. Si la source et les consignes restent inchangées, la régénération peut produire la même formulation.
Délimiter le sens du terme pour sélectionner les messages #
Définissez le sens du terme avant de sélectionner les messages. Par exemple, l’« espace de travail » d’un produit peut désigner un espace de projet partagé, tandis qu’un autre passage décrit un espace de travail physique. Consignez dans le glossaire le sens voulu pour le produit et le terme cible approuvé par l’équipe, puis sélectionnez uniquement les messages qui emploient le terme dans ce sens. La page Limites des termes approfondit ce choix.
Sélectionner une clé cible existante avec la CLI #
Dans un projet configuré qui utilise cette source JSON à l’emplacement locales/en/account.json :
lingo push "locales/en/account.json" --key "account.invitation" --waitPour JSON, --key régénère les unités sélectionnées même lorsque le texte source est inchangé. Cette opération actualise ces clés dans chaque langue configurée disposant déjà d’un fichier cible, en fusionnant les nouvelles valeurs dans ce fichier.
Enregistrez les corrections existantes avant l’actualisation : la version cible capturée lors de cet envoi peut être remplacée pour les clés sélectionnées. Pour détecter les modifications de la cible effectuées après la soumission, omettez --wait et inspectez lingo pull --dry-run avant de récupérer les résultats. Consultez la classification des modifications locales lors de la récupération pour savoir comment gérer les conflits.
L’actualisation des clés laisse inchangée la version de référence de l’ensemble de la source, que les résultats soient récupérés par push --wait ou par une opération de récupération distincte. Les modifications courantes de la source encore en attente seront donc toujours transmises lors d’un envoi simple ultérieur.
Les motifs de clés prennent en charge les clés exactes, les préfixes d’objets et les caractères génériques * couvrant un segment entier. auth.login peut inclure auth.login.title sans correspondre à auth.login_url. Placez les caractères génériques entre guillemets et répétez --key pour spécifier plusieurs motifs.
JSONC, TypeScript et PHP suivent le même fonctionnement pour l’actualisation ciblée. YAML et YAML avec une langue à la racine peuvent conserver les traductions sélectionnées dont la source est inchangée ; modifiez directement la cible pour une correction précise ou enregistrez les versions cibles acceptées avant de régénérer le fichier entier. La page Périmètres de la CLI détaille le comportement de chaque format et définit la notation des clés.
Trouver les clés ou les fichiers concernés par un terme #
Repérez les messages sources qui emploient le terme dans le sens voulu et examinez leur contexte. Sélectionnez leurs clés prises en charge avec --key, à l’aide de la commande ci-dessus. Pour les formats qui nécessitent de régénérer le fichier entier, enregistrez les versions cibles acceptées et actualisez les fichiers sources concernés, par exemple :
lingo push 'docs/en/workspaces.md' --force --waitUtilisez un chemin source déjà sélectionné dans votre configuration. Cette opération remplace les traductions de ce fichier pour les langues cibles configurées. Comparez l’intégralité du message ou du fichier réécrit, y compris le texte qui entoure le terme.
Vérifier les modifications, la préservation et l’utilisation #
Pour chaque chemin cible modifié, comparez le contenu à la version enregistrée. Dans l’exemple, l’invitation doit conserver l’exigence d’approbation avant l’accès, et le message d’assistance doit correspondre à sa version de référence acceptée. Si des éléments voisins manquent ou si des réécritures inattendues apparaissent, vérifiez le périmètre et la version de référence avant d’accepter le résultat.
Vérifiez les variables et les contrôles des clés : le verrouillage copie le texte source, la préservation conserve une valeur cible et l’exclusion supprime le contenu de la sortie d’un format qui la prend en charge.
Chargez la sortie dans l’environnement d’exécution qui l’utilise. Pour les documents, examinez le passage modifié, les liens et les composants. Résolvez les conflits de récupération avant de remplacer les modifications locales, puis committez les versions cibles acceptées avec la révision de leur source et le Lockfile.