Inicio rápido

Instala la CLICopiar enlace a esta sección

npm install --save-dev @verbatra/cli

Los comandos de abajo usan npx. Con pnpm, yarn o bun, ejecuta pnpm verbatra, yarn verbatra o bun run verbatra. Si pnpm termina con ERR_PNPM_IGNORED_BUILDS, consulta Solución de problemas.

Añade un archivo de locale de origenCopiar enlace a esta sección

Si tu proyecto ya tiene archivos de locale, sáltate este paso. Si no, crea uno:

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

Genera una configuraciónCopiar enlace a esta sección

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

--format indica el formato de tus archivos: Elige tu stack tiene el id de cada framework. --yes acepta lo que init detectó en lugar de preguntar; sin él, respondes a las preguntas que enumera 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.)

El nuevo verbatra.config.ts traduce de en a de. Añade códigos a targetLocales para más idiomas.

Previsualiza la ejecución sin claveCopiar enlace a esta sección

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)

Esta es la forma en un terminal interactivo; con una tubería o en CI, cada paso tiene además su propia línea, consulta Salida en el terminal. Una ejecución de prueba no construye ningún proveedor, así que no necesita clave, no gasta nada y no escribe nada. verbatra doctor comprueba el resto de la configuración de la misma forma.

TraduceCopiar enlace a esta sección

cp .env.example .env

Abre .env y pega tu clave después de GEMINI_API_KEY=. Las claves solo vienen del entorno, y la CLI carga en él .env.local y .env. ¿Aún no tienes clave? Gemini tiene un nivel gratuito: crea una en Google AI Studio. Los demás proveedores y sus variables están en Proveedores.

npx @verbatra/cli translate

verbatra envía las dos claves que faltan a Gemini, comprueba cada resultado y escribe el archivo en alemán. El resumen empieza con de: 2 translated, 0 unchanged e indica los tokens que usó la ejecución. El texto depende del modelo, por ejemplo:

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

Comprueba que cada locale está sincronizadoCopiar enlace a esta sección

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 no llama a ningún proveedor y termina con 1 en cuanto un locale deja de estar sincronizado, así que el mismo comando puede proteger un pull request.