Documentation

Garde chaque fichier de locale aligné sur ta source.

verbatra traduit tes fichiers de locale i18n de façon incrémentale : il n'envoie que les chaînes nouvelles et modifiées au fournisseur que tu configures, vérifie chaque résultat, et réécrit les fichiers en place.

npm i -D @verbatra/cli
Démarrage rapideRéférence CLI
~/acme-shop

An example verbatra command-line session.

  1. verbatra init
    • ✓ created verbatra.config.ts
    • source en · targets de, es, fr
    • provider gemini · key from GEMINI_API_KEY
  2. verbatra translate
    • diff en.json · 12 new · 0 changed · 108 unchanged
    • de 12 translated · 108 unchanged · 0 withheld
    • es 12 translated · 108 unchanged · 0 withheld
    • fr 12 translated · 108 unchanged · 0 withheld
    • ✓ 36 keys translated in 5.4s · 0 skipped · lock updated
  3. verbatra diff
    • en.json · 120 keys · source of truth
    • de 2 new · 1 changed · 117 up to date
    • es 0 new · 0 changed · 120 up to date
    • fr 5 new · 0 changed · 115 up to date
    • 8 keys would be sent · run verbatra translate to apply
  4. verbatra watch
    • watching en.json for changes
    • en.json changed · 1 new key
    • de 1 translated · 0 withheld
    • ✓ 3 keys translated · waiting for changes

Où aller ensuite

Nouveau iciTa première traductionInstalle la CLI, génère une configuration, définis ta clé, et traduis.Déjà en placeAjouter une langueAjoute une locale à ta configuration et laisse une exécution la remplir.Sous le capotComment ça marcheLe pipeline : comparer avec la référence du fichier de verrouillage, traduire, vérifier, écrire.Avec un agent IAConfigurer avec l'IADonne à Claude Code, Cursor ou tout agent de codage un prompt prêt à copier-coller.

Ce que fait verbatra

Maintenir à la main une seule locale source signifie que tous les autres fichiers de locale dérivent : les nouvelles clés manquent dans les cibles, les chaînes modifiées laissent derrière elles des traductions périmées, et les clés supprimées traînent en orphelines. verbatra comble cet écart en comparant chaque cible à un fichier de verrouillage commité, verbatra.lock.json, et en n'envoyant que ce qui a changé au fournisseur que tu configures ; une deuxième exécution sans rien de nouveau à traduire ne fait aucun appel fournisseur. Chaque résultat est vérifié avant d'être écrit, donc un placeholder cassé est retenu et retenté, jamais livré. Voir Comment ça marche pour le pipeline complet.

verbatra lit et écrit douze formats et traduit via six fournisseurs derrière une seule interface. Voir Formats et Fournisseurs.

Les paquets

@verbatra/cli

Le binaire verbatra : dix commandes, une fine couche au-dessus du SDK. Commence ici.

@verbatra/sdk

Le moteur en dessous : translate, watch, check, diff, doctor, et l'aller-retour Excel.

@verbatra/studio

Un tableau de bord local avec édition intégrée et une file de révision. La dépense fournisseur reste désactivée tant que tu ne l'actives pas.

@verbatra/mcp

Un serveur MCP en stdio qui expose le statut de traduction, le glossaire et les outils d'édition à un client MCP.