Récupérer une exécution de localisation interrompue

Identifiez ce que l’exécution soumise a réellement terminé, récupérez les résultats disponibles et préservez vos corrections locales tout en réglant les problèmes restants.

Fermer le terminal pendant lingo push --wait ne suffit pas à arrêter le serveur. La traduction peut être encore en cours, en attente de relecture ou déjà terminée. Vérifiez son état avant de soumettre à nouveau le même contenu.

Ce guide porte sur les travaux déjà soumis. Pour une nouvelle correction, utilisez une mise à jour ciblée. Pour conserver les traductions cibles acceptées lors des modifications ordinaires, consultez les consignes de préservation.

Conserver les éléments de diagnostic et l’état local #

Notez l’identifiant d’exécution affiché, la révision de la source, les fichiers et les langues sélectionnés, ainsi que le dernier statut connu. Conservez l’état d'exécution du checkout, le Lockfile et toutes les modifications locales des traductions cibles. Supprimer ces données en premier risque de faire disparaître les informations nécessaires pour récupérer le travail.

Si l’exécution a été soumise pour deux langues cibles, examinez chaque cible séparément : ne supposez pas que la fermeture du terminal les a toutes deux interrompues au même stade.

Vérifier la récupération avant de recommencer #

Depuis le checkout utilisé pour la soumission, utilisez l’exécution qui y est enregistrée :

bash
lingo pull --dry-run

Cette opération vérifie les écritures locales prévues sans modifier les fichiers. Elle peut interroger périodiquement le serveur sur les travaux inachevés et signaler une attente de relecture, un échec ou des résultats disponibles. La commande pull écrit chaque document une fois toutes ses langues terminées et laisse intacts les documents en attente de relecture humaine ; exécutez-la à nouveau une fois la relecture terminée. Traitez la relecture requise dans son propre workflow plutôt que de soumettre sans cesse la source à nouveau.

Lorsque les résultats sont prêts, examinez les conflits, puis récupérez-les :

bash
lingo pull

La commande pull utilise l’état enregistré localement ; elle ne recherche pas d’autres exécutions depuis une autre machine. Récupérez les traductions committées ailleurs via le système de gestion de versions. La référence sur l’état d'exécution et la page Pull précisent les fichiers utilisés par la CLI installée et les règles de gestion des conflits.

Réessayer les travaux ayant échoué avec push #

Après avoir corrigé la cause signalée, exécutez à nouveau la commande push initiale avec les mêmes arguments, depuis le checkout utilisé pour la soumission. Pour une mise à jour ordinaire de la source :

bash
lingo push --wait

Si les résultats du précédent push n’ont jamais été récupérés et que la requête n’a pas changé, push réutilise la soumission précédente au lieu de soumettre le même travail deux fois. La commande se rattache à une tâche encore en cours, récupère les résultats d’une tâche terminée et remplace une tâche ayant échoué par une nouvelle tâche dotée d’un nouvel identifiant. Les documents récupérés avant un échec sont déjà enregistrés dans le Lockfile ; la nouvelle tentative ne demande donc que les travaux encore manquants ou modifiés.

Après la nouvelle tentative, examinez les résultats pour chaque cible et les fichiers récupérés, puis identifiez ce qu’il reste à faire. Avant de compléter les fichiers cibles manquants dans un projet existant, terminez, récupérez et examinez les mises à jour ordinaires de la source pour les cibles existantes. Gardez cette révision de la source inchangée pendant que vous complétez les fichiers manquants avec lingo push --backfill-missing --wait ; Ajouter une langue détaille la marche à suivre. Les clés modifiées dans des fichiers existants nécessitent, quant à elles, une mise à jour ordinaire ou ciblée adaptée.

Adapter la correction à l’échec #

Un enregistrement local manquant n’est pas la même chose qu’une exécution ayant échoué sur le serveur. Un contenu invalide demande une correction, une autorisation refusée demande un accès, et une attente de relecture demande une décision. Si la réponse du réseau est incertaine, vérifiez si le serveur a accepté le travail avant de le soumettre à nouveau.

Ne modifiez pas la source dans le seul but de retenter une exécution ayant échoué. Conservez l’ancien identifiant d’exécution et vérifiez que le nouvel identifiant de tâche affiché est différent. La procédure de récupération de la CLI explique comment vérifier les résultats et contacter l’assistance si la même tâche en échec est renvoyée.

En cas de résultats partiels, conservez les traductions cibles réussies ayant fait l’objet d’une relecture et répertoriez séparément les cibles en échec. Si une nouvelle exécution est nécessaire, notez pourquoi elle fait suite à la précédente ou la remplace, ainsi que la révision de la source qu’elle utilise. Vous éviterez ainsi de confondre un résultat tardif avec le résultat actuel.

Résoudre les divergences locales #

La commande pull peut refuser de remplacer une traduction cible modifiée depuis sa version enregistrée. Comparez la modification locale et le résultat à récupérer à leurs révisions sources respectives, puis choisissez la formulation à accepter lors de la relecture.

lingo pull --force contourne cette protection et écrase les traductions cibles divergentes. Sauvegardez d’abord votre travail local et assurez-vous de vouloir le remplacer. Avec des catalogues partagés, protégez le fichier entier, y compris la source et les langues non modifiées.

Terminer avec des résultats utilisables #

Comparez les chemins récupérés, les langues, les variables et les différences. Chargez le résultat dans son application ou son moteur de rendu et vérifiez le sens. Un fichier peut être récupérable sans que son utilisation soit approuvée.

Conservez l’identifiant de l’exécution récupérée, la révision acceptée, le Lockfile et les traductions cibles comme nouvelle base de référence. La récupération est terminée lorsque les échecs restants sont pris en compte et que les résultats acceptés correspondent à la source prévue, pas simplement lorsqu’une commande se termine avec succès.