verbatra import
Réimporte une remise remplie (classeur, CSV ou TSV) dans les fichiers de locale, avec les mêmes vérifications de sûreté.
Page traduite automatiquement
Relis dans tes fichiers de locale un classeur rempli par un traducteur. Chaque valeur passe par les mêmes vérifications d'intégrité qu'une exécution automatisée : les valeurs qui passent sont écrites et le fichier de verrouillage est mis à jour ; les valeurs qui échouent sont retenues et signalées au lieu d'être écrites, donc une cellule défectueuse n'atterrit jamais dans un fichier de locale.
Synopsis
verbatra import <workbook> [flags]<workbook> est le chemin de la remise produite par verbatra export et remplie par le traducteur : le fichier du classeur avec xlsx, et avec csv et tsv soit un seul fichier <locale>.csv, soit le répertoire qui en contient un par locale.
Options
| Option | Argument | Défaut | Effet |
|---|---|---|---|
--cwd | <path> | répertoire courant | résout la config et les fichiers de locale depuis ce répertoire |
--config | <path> | recherche automatique | charge ce fichier de config au lieu d'en chercher un |
--dry-run | aucun | désactivé | valide et rapporte sans écrire les fichiers de locale ni mettre à jour le verrou |
--format | <format> | xlsx | lit un classeur Excel (xlsx) ou des fichiers délimités (csv, tsv) |
--json | aucun | désactivé | affiche une enveloppe JSON sur stdout portant le résumé d'exécution sous result (la même forme RunSummary que translate), ou le code d'erreur si l'exécution échoue ; la ligne d'erreur lisible par un humain va toujours sur stderr |
Exemples
# import the filled workbook
verbatra import verbatra-translations.xlsx
# validate and report, write nothing
verbatra import verbatra-translations.xlsx --dry-run
# import every locale file in a CSV handoff directory
verbatra import handoff --format csvAvec csv ou tsv, la locale vient du nom du fichier et non d'un nom de feuille : garde donc chaque fichier nommé exactement comme il a été exporté. Une locale cible configurée sans fichier est rapportée comme l'échec de cette locale, jamais ignorée en silence.
Un fichier laissé par un export antérieur avec une sélection --locales plus large n'est jamais appliqué. L'import rapproche le répertoire du manifeste que l'export le plus récent y a écrit et rapporte cette locale en échec avec HANDOFF_FILE_STALE, si bien qu'une traduction périmée ne peut pas revenir sans qu'on le voie. Réexporte cette locale pour rafraîchir son fichier, ou supprime le fichier. Un répertoire sans manifeste lisible (assemblé à la main, ou ayant perdu le fichier caché en passant par une archive) est lu comme avant, chaque fichier présent est importé. Un fichier unique nommé directement est de même pris au mot.
Codes de sortie
| Code | Signification |
|---|---|
0 | chaque locale cible est ressortie complète |
1 | l'exécution a terminé mais une ou plusieurs locales ont échoué ou sont ressorties partielles |
2 | impossible de s'exécuter : une erreur globale (config, classeur, format ou verrou) ou une erreur d'utilisation |
Le contrat correspond à verbatra translate, donc une passation manuelle se branche de la même façon en CI. Cela inclut les locales partielles : une locale écrite avec des clés toujours manquantes sort avec 1, pas 0. Cela inclut aussi le fichier de verrouillage : un fichier de verrouillage corrompu, ou qui le devient pendant l'import, interrompt toute l'exécution avec 2 au lieu de signaler une seule locale en échec, si bien que les locales restantes ne sont pas touchées. Les locales appliquées avant l'interruption restent écrites : répare le fichier de verrouillage puis relance l'import.
Une cellule Translation vide ne fait jamais échouer une locale : la ligne est sautée, la ligne de base antérieure de son verrou est conservée, et la clé est rapportée comme unfilled dès qu'elle demande toujours une traduction, que la ligne ait été exportée comme new ou changed. Importer un classeur que personne n'a encore rempli réussit donc et renvoie l'inventaire complet des clés en attente.
Voir aussi
- Traduction humaine couvre l'aller-retour complet export, remplissage, import et ce qu'un traducteur peut modifier.
- Sûreté de la traduction explique les vérifications qui peuvent retenir une valeur.
verbatra exportproduit la remise que cette commande lit.