Démarrage rapide

Installe la CLICopier le lien vers cette section

npm install --save-dev @verbatra/cli

Les commandes ci-dessous utilisent npx. Avec pnpm, yarn ou bun, lance plutôt pnpm verbatra, yarn verbatra ou bun run verbatra. Si pnpm s'arrête avec ERR_PNPM_IGNORED_BUILDS, consulte le dépannage.

Ajoute un fichier de locale sourceCopier le lien vers cette section

Si ton projet a déjà des fichiers de locale, passe cette étape. Sinon, crées-en un :

{
  "greeting": "Hello, {{name}}!",
  "cart": {
    "empty": "Your cart is empty."
  }
}

Génère une configurationCopier le lien vers cette section

npx @verbatra/cli init --format i18next-json --provider gemini --yes

--format indique le format de tes fichiers : Choisis ta stack donne l'id pour chaque framework. --yes reprend ce que init a détecté au lieu de poser des questions ; sans lui, tu réponds aux questions que liste verbatra init.

created verbatra.config.ts
created .env.example
created .gitignore (.env, .env.local, .verbatra-local/, verbatra.cache.json)
detected format i18next-json, pattern locales/{locale}.json, locales en (confidence: medium)
next steps:
  - Copy .env.example to .env and set GEMINI_API_KEY there. Never commit .env.
  - npx @verbatra/cli doctor  (Check the setup. It calls no provider and reads no key value.)
  - npx @verbatra/cli translate --dry-run  (Preview what a run would translate, without calling the provider.)

Le nouveau verbatra.config.ts traduit de en vers de. Ajoute des codes à targetLocales pour d'autres langues.

Prévisualise l'exécution sans cléCopier le lien vers cette section

npx @verbatra/cli translate --dry-run

verbatra: dry run over 1 locale, no provider call
verbatra: de done, 2 would translate
verbatra translate (dry run)
  de: 2 would translate, 0 unchanged
1 succeeded, 0 partial, 0 failed (dry run: nothing written)
[ok] dry run done in 0.0s, nothing written
next: verbatra translate (run it for real)

Voici la forme dans un terminal interactif ; dans un pipe ou en CI, chaque étape a aussi sa propre ligne, voir Sortie dans le terminal. Une exécution à blanc ne construit aucun fournisseur : elle n'a pas besoin de clé, ne dépense rien et n'écrit rien. verbatra doctor vérifie le reste de la configuration de la même façon.

TraduisCopier le lien vers cette section

cp .env.example .env

Ouvre .env et colle ta clé après GEMINI_API_KEY=. Les clés viennent uniquement de l'environnement, et la CLI y charge .env.local et .env. Pas encore de clé ? Gemini a une offre gratuite : crées-en une dans Google AI Studio. Les autres fournisseurs et leurs variables sont sur Fournisseurs.

npx @verbatra/cli translate

verbatra envoie les deux clés manquantes à Gemini, vérifie chaque résultat et écrit le fichier allemand. Le résumé commence par de: 2 translated, 0 unchanged et indique les tokens utilisés par l'exécution. La formulation dépend du modèle, par exemple :

{
  "greeting": "Hallo, {{name}}!",
  "cart": {
    "empty": "Dein Warenkorb ist leer."
  }
}

Vérifie que chaque locale est synchroniséeCopier le lien vers cette section

npx @verbatra/cli check

[ok] checking the locales (0.0s)
verbatra check
  de: 0 missing, 0 stale, 2 up-to-date (in sync)
all locales in sync

check n'appelle aucun fournisseur et se termine avec 1 dès qu'une locale n'est plus synchronisée : la même commande peut donc protéger une pull request.