lingo push
Soumettez les modifications des sources, créez les fichiers cibles manquants ou actualisez volontairement les traductions de votre choix.
Après la configuration du premier fichier, utilisez lingo push --wait pour les modifications courantes des sources. La CLI compare les octets des sources à sa référence, demande le traitement des modifications et télécharge les cibles terminées. Les sources identiques octet par octet sont ignorées.
Les autres modes répondent à des besoins distincts. Choisissez-les selon ce qui doit changer, plutôt que de traiter chaque push comme une traduction complète.
Choisir le travail à effectuer #
| Commande | Comportement |
|---|---|
| Push simple sans référence valide | Stocke les octets des sources sans demander automatiquement de traduction initiale. |
| Push simple avec une référence | Traduit les modifications des sources de manière incrémentale. |
lingo push 'locales/en.json' | Planifie le travail sur un périmètre défini, sans la comparaison habituelle avec la source précédente ; les cibles existantes peuvent être adoptées. |
lingo push --backfill-missing | Crée les fichiers cibles manquants pour toutes les sources configurées. |
Push sur un périmètre défini avec --force | Régénère les cibles sélectionnées dans des fichiers séparés sans conserver le contexte des cibles existantes. |
Push avec --key | Sélectionne les unités à clés stables dans les cibles existantes ; la réutilisation des valeurs inchangées dépend du format. |
Le remplissage rétroactif n'ajoute pas de clés nouvelles ou modifiées à un fichier cible ordinaire déjà existant. Il signale les modifications des sources depuis la référence ; effectuez ces mises à jour courantes avec un push simple avant le remplissage rétroactif pour garder les langues existantes à jour. Un document qui ne couvre qu'une partie des langues configurées conserve la référence source existante : un push ordinaire ultérieur peut ainsi traiter les modifications en attente pour les autres langues. Les catalogues XCStrings partagés utilisent une planification par langue. Les motifs positionnels ne sélectionnent que les fichiers correspondant à la configuration, et non des fichiers arbitraires.
Options #
| Option | Effet |
|---|---|
| Motifs positionnels | Sélectionnent les fichiers configurés ; placez les caractères génériques du shell entre guillemets. |
--force, -f | Remplacent les traductions de fichiers entiers ; utilisez des motifs de fichiers explicites ou le remplissage rétroactif. |
--backfill-missing | Initialise les fichiers cibles manquants. |
--key <pattern> | Sélection d'unités stables, répétable. |
--yes, -y | Désactivent la confirmation du remplacement forcé. |
--wait, -w | Attendent et téléchargent les résultats au lieu de rendre la main après la soumission. |
--estimate | Planifie le travail et en estime le coût sans traduire ni créer de tâche. |
--with <stage> | Exécuter une étape pour cet envoi uniquement ; option pouvant être répétée. |
--without <stage> | Ignorer une étape pour cet envoi uniquement ; option pouvant être répétée. |
--review-*, --content-length | Ajuster les paramètres d'une étape pour cet envoi uniquement. |
Les options booléennes valent false par défaut. Les cibles proviennent de la configuration ; push n'a pas d'option de langue. Le remplacement forcé de fichiers entiers demande une confirmation, sauf si l'option yes, un périmètre limité aux clés ou une estimation la désactive. Sans motifs positionnels, --force sélectionne tous les fichiers sources et toutes les langues cibles définis dans la configuration. Utilisez des motifs de fichiers explicites et vérifiez le périmètre avec --estimate avant un remplacement étendu. Le remplacement forcé peut écraser les modifications manuelles des cibles, car il efface le contexte de la cible actuelle pour les formats à fichiers séparés. Les catalogues XCStrings et les tables CSV peuvent toutefois réutiliser les traductions intégrées au fichier source partagé.
Actualiser les clés sélectionnées #
Utilisez une actualisation par clé lorsque les consignes enregistrées ont changé, mais pas le texte source, ou lorsqu'un sous-ensemble précis doit être retraduit :
lingo push 'locales/en.json' --key 'checkout.title' --key 'checkout.submit' --waitLes clés sont des chemins exprimés avec des points et des crochets. Sélectionner un objet inclut toutes les chaînes qu'il contient : auth.login inclut auth.login.title, mais pas auth.login_url. * représente un segment entier. La notation avec des barres obliques de l'ancienne CLI, comme auth/login, fonctionne également. JSON, JSONC, TypeScript et PHP régénèrent les chaînes sélectionnées même si leur source est inchangée. YAML et YAML à clés racines acceptent la sélection par clé, mais peuvent réutiliser les valeurs cibles actuelles lorsque leur source correspond à la référence enregistrée. Pour corriger une formulation en YAML, modifiez directement la cible ; pour une régénération plus étendue après un changement de consignes, enregistrez les cibles acceptées et utilisez --force sur le fichier entier sans --key.
Les langues cibles manquantes et les formats sans clés stables sont ignorés, avec des messages pour le signaler ; les autres formats interrompent le push avec une erreur. Initialisez les cibles manquantes séparément. Ajouter --force à --key ne modifie pas la planification limitée aux clés et n'empêche pas la réutilisation des valeurs YAML.
Un push limité aux clés laisse la référence de la source entière inchangée, que ses résultats soient récupérés par push --wait ou par un pull ultérieur. Les modifications courantes des sources encore en attente seront donc traitées lors du prochain push simple. La section Périmètres présente la matrice des formats et la syntaxe des clés.
Estimer avant un remplacement étendu #
lingo push 'locales/en.json' --force --estimateL'estimation planifie précisément les modifications sans traduire ni créer de tâche. Elle téléverse les fichiers qui manquent au serveur pour ce plan : il s'agit donc d'un appel au service, et non d'une simulation hors ligne. Elle ne remplace ni le pointeur de récupération enregistré ni la référence établie à l'issue du traitement. Un premier push stocke uniquement les sources ; son estimation indique donc qu'il n'y a rien à estimer et renvoie vers lingo push --estimate --backfill-missing.
Les résultats affichent le coût prévu, les traductions à produire et à réutiliser, les tokens de sortie et le détail par langue. Le coût éventuel des corrections ultérieures et les dépenses facturées par votre propre fournisseur d'IA figurent sur des lignes séparées et sont exclus du total prévu ; des avertissements précisent ensuite ce que l'estimation exclut. Les montants marqués ~ sont approximatifs. Ils décrivent le plan, et ne correspondent ni à une consommation mesurée ni à un devis. Un push trop volumineux pour être estimé échoue en indiquant le motif fourni par le serveur ; utilisez des motifs de fichiers pour n'en estimer qu'une partie.
Modifier les étapes pour un seul envoi #
lingo push 'locales/en.json' --force --wait --with human-review --review-level strict --review-timeout 12 --without pre-editLes options d'étape modifient le pipeline du moteur pour cet envoi uniquement. Vous pouvez ainsi tester une configuration sans modifier ni recréer le moteur. Tous les paramètres non spécifiés par une option sont ceux du moteur, y compris ses groupes de relecture humaine.
--with et --without acceptent pre-edit, rephrase, human-review, post-edit, content-length ou back-translation. La traduction s'exécute toujours. --without ignore aussi les étapes qui dépendent de l'étape ignorée : --without human-review ignore l'évaluation IA et la post-édition.
| Paramètre | Valeurs |
|---|---|
--review-level | everything envoie toutes les unités aux relecteurs ; strict, medium ou lax n'envoie que les unités signalées par l'évaluation IA à ce niveau de gravité. |
--review-pool <name> | La relecture fait appel à ce groupe plutôt qu'aux groupes du moteur. |
--review-languages <locales> | Langues relues par le groupe --review-pool, séparées par des virgules ; toutes les langues par défaut. |
--review-timeout <hours> | Le nombre d'heures accordées aux relecteurs. |
--content-length <rule> | source, match:<percent> ou max:<columns>. |
Un paramètre ajuste une étape sans l'activer. L'envoi échoue donc si cette étape ne s'exécute pas : ajoutez --with human-review ou --with content-length. Sur un moteur sans groupes de relecture, --with human-review nécessite --review-pool. Si vous demandez une étape non disponible dans votre forfait, l'envoi échoue au lieu d'ignorer cette étape. L'envoi enregistre ses résultats comme tout autre envoi ; ajoutez --force ou --key pour retraduire les unités inchangées, et --estimate pour estimer au préalable le coût de la configuration. Toute nouvelle tentative doit reprendre les mêmes options d'étape.
Pour ajouter une langue, terminez d'abord les mises à jour courantes des sources pour les cibles existantes. Ajoutez-la ensuite à targetLocales, vérifiez lingo push --backfill-missing --estimate et demandez un remplissage rétroactif sans modifier la révision source. La section Ajouter une langue détaille cette séquence jusqu'aux vérifications dans l'application. Supprimer une langue empêche sa sélection à l'avenir sans supprimer les fichiers. N'utilisez pas la purge de langue sur les catalogues XCStrings partagés.
Récupérer les résultats et reprendre après un échec #
Sans attente, conservez le checkout et le pointeur local à la machine jusqu'à ce que pull récupère les résultats. Un autre push peut remplacer ce pointeur. En mode attente, examinez les résultats en échec total ou partiel ainsi que les fichiers effectivement téléchargés. L'attente s'arrête dès que toutes les cibles inachevées attendent une relecture humaine ; exécutez pull une fois que les évaluateurs ont terminé. Ne modifiez pas les cibles pendant la récupération directe en mode attente : contrairement à pull, celle-ci n'effectue pas de nouvelle comparaison des modifications locales.
Pour réessayer un traitement en échec, corrigez la cause et suivez la procédure de reprise après une exécution en échec : relancez le push approprié en conservant l'état, confirmez l'identifiant de tâche affiché, puis examinez les résultats obtenus. Si les résultats du push précédent n'ont jamais été récupérés et que la demande est inchangée, push réutilise cette demande au lieu de la dupliquer : il se rattache à une tâche en cours, récupère les résultats d'une tâche terminée et remplace une tâche en échec par une nouvelle.