Préserver les traductions relues lors des mises à jour
Conservez ensemble la source et la traduction acceptée comme versions de référence, choisissez le bon mode de mise à jour et vérifiez précisément ce qui a changé.
Une traduction acceptée représente un travail qui mérite d’être préservé. Lorsqu’un message source change, les messages voisins peuvent rester corrects. La réutilisation permet de les conserver si le workflow reçoit les bonnes versions de référence et applique le comportement de fusion prévu.
Le terme « incrémental » ne suffit pas à décrire cette protection. Conservez la source précédente et la traduction acceptée, choisissez le contrat de mise à jour de l’appelant et examinez les différences réelles. Pour une correction connue dans la traduction cible, utilisez les mises à jour d’une seule clé ; pour un travail soumis dont l’exécution s’est interrompue, commencez par la reprise.
Consigner ce qui doit changer et ce qui doit être conservé #
Prenons cet exemple de source :
{
"retention": "Reports remain available for 30 days.",
"support": "Contact support",
"productName": "ExampleApp"
}La personne responsable de la source porte la durée de conservation à 60 jours. Conservez l’ancienne source, la nouvelle source et la traduction relue. La durée indiquée dans la traduction doit changer ; la formulation acceptée de support doit rester intacte. Garder productName identique à la source répond à une autre exigence que préserver une formulation cible relue.
Enregistrez la dernière révision acceptée de la traduction, y compris les modifications locales apportées depuis le téléchargement et leur justification. La version de référence du serveur et la traduction dans l’arbre de travail peuvent désormais différer.
Utiliser la planification habituelle des différences pour les modifications de la source #
Dans la CLI actuelle, l’utilisation habituelle de lingo push --wait s’appuie sur l’état enregistré de la source et sur les traductions cibles pour planifier les modifications. Conservez la configuration, la source, les traductions acceptées et .lingo/lock.json sous gestion de versions. Supprimer le Lockfile modifie la planification ; ce n’est pas une simple actualisation sans conséquence.
--backfill-missing crée les fichiers cibles manquants, mais ne traite pas chaque clé manquante ou modifiée dans les fichiers existants. Les motifs de source passés en arguments positionnels utilisent une planification à périmètre limité, avec un comportement de réutilisation différent. --force régénère les cibles sélectionnées stockées dans des fichiers distincts et peut remplacer du texte accepté ; les catalogues XCStrings partagés peuvent toutefois réutiliser leurs traductions intégrées. Consultez la référence de Push pour choisir le comportement avant de demander un remplacement.
Examinez le périmètre et, si cela vous est utile, obtenez une estimation avant de lancer une exécution à grande échelle. Après la récupération, comparez la valeur modifiée et les valeurs acceptées voisines. Vérifiez ce qui a été préservé à partir du résultat, et non du libellé de l’exécution.
Distinguer le verrouillage de la source de la préservation de la traduction #
Une clé verrouillée, lorsque le format le permet, copie le texte source dans la traduction cible. Une clé préservée conserve une valeur cible existante. Verrouiller un message français relu peut donc le remplacer par de l’anglais ; cela ne protège pas la formulation française.
Les contrôles des clés dépendent du format. Exclure une clé de la sortie correspond encore à un autre comportement. Une valeur dont les faits ont changé dans la source ne doit pas être préservée sans condition, au risque de conserver un sens obsolète.
Concilier les corrections locales lors de la récupération #
Enregistrez les corrections existantes avant de soumettre une mise à jour. La traduction cible exacte capturée par push peut être remplacée dans le cadre de cette mise à jour. Pour détecter les modifications apportées après la soumission, omettez --wait, puis examinez lingo pull --dry-run. Pull compare les traductions locales à la traduction capturée et aux empreintes enregistrées, et peut refuser d’écraser les modifications ultérieures ; le téléchargement direct depuis push --wait n’effectue pas cette nouvelle vérification.
En cas de conflit, comparez la correction locale, la traduction enregistrée et le résultat reçu aux révisions pertinentes de la source. Préservez toute correction encore applicable en suivant le processus habituel de relecture. Utilisez lingo pull --force uniquement après avoir enregistré le travail local et choisi délibérément le remplacement. Le forçage contourne la protection ; il ne choisit pas la bonne formulation.
Pour les catalogues Apple partagés, conservez le fichier entier et vérifiez les langues non modifiées. Ne supprimez pas un fichier contenant la source et plusieurs langues comme s’il s’agissait d’un simple fichier cible jetable.
Accepter la nouvelle version de référence après vérification #
Dans cet exemple, vérifiez la durée de 60 jours dans la nouvelle traduction, la valeur préservée de support et le comportement prévu de productName. Vérifiez les variables et la structure dans l’environnement d’exécution qui les utilise. Les différences révèlent les modifications ; la relecture linguistique détermine si la nouvelle affirmation est correcte.
Conservez la traduction acceptée avec la révision correspondante de la source comme prochaine version de référence. Si la correction doit modifier les consignes futures, prenez une décision distincte concernant le glossaire ou les règles, plutôt que de supposer qu’une modification acceptée suffit à enseigner une nouvelle politique au moteur de localisation.