verbatra translate
Traduce cada locale de destino una vez y luego termina.
Página traducida automáticamente
Ejecuta una pasada de traducción sobre cada locale de destino y luego sal. translate lee el locale de origen, lo compara con el archivo de bloqueo, envía al proveedor solo las cadenas nuevas o modificadas, ejecuta las comprobaciones de integridad, escribe los archivos de locale y actualiza el bloqueo. Lo que sigue al día nunca se reenvía, así que nunca pagas dos veces por una cadena sin cambios.
Sinopsis
verbatra translate [flags]Flags
| Flag | Argumento | Por defecto | Efecto |
|---|---|---|---|
--cwd | <path> | directorio actual | resuelve la configuración y los archivos de locale desde este directorio |
--config | <path> | busca uno | carga este archivo de configuración en lugar de buscar uno |
--dry-run | ninguno | desactivado | previsualiza los cambios sin llamar a un proveedor ni escribir archivos |
--prune | ninguno | la opción prune de la configuración, si no, desactivado | elimina del archivo escrito y del bloqueo las claves huérfanas (en un archivo de destino pero ausentes del origen) |
--concurrency | <n> | 1 | traduce hasta n locales de destino a la vez; debe ser un entero positivo |
--no-cache | ninguno | desactivado (caché activada) | omite la caché de memoria de traducción local (verbatra.cache.json) para esta ejecución |
--json | ninguno | desactivado | imprime el resumen de la ejecución como un objeto JSON en stdout (la forma RunSummary); los errores siguen yendo a stderr |
Por defecto una ejecución no borra nada: las claves huérfanas se informan y se dejan en su sitio. --prune elimina exactamente esas claves y nada más, y anula la opción prune de la configuración para esta ejecución. Antes de ejecutarse, translate carga .env.local y luego .env desde el directorio de trabajo; una variable ya definida en el entorno real gana.
--concurrency traduce varios locales de destino en paralelo para terminar antes un proyecto grande. Se rechaza con salida 2 cuando la configuración fija un presupuesto maxTokens, porque los locales concurrentes no pueden respetar un tope de tokens de forma determinista (un dry-run queda exento). A medida que avanza una ejecución, el progreso se imprime en stderr (una línea por inicio de locale, sub-lote del proveedor y fin de locale), así que el stdout de una ejecución con --json sigue siendo un único resumen limpio. --no-cache se salta la caché de memoria de traducción para la ejecución, haciendo exactamente las llamadas al proveedor que haría sin caché presente.
Ejemplos
# translate once using the config it finds
verbatra translate
# preview the keys that would be pruned, spending nothing
verbatra translate --prune --dry-runCódigos de salida
| Código | Significado |
|---|---|
0 | todos los locales de destino tuvieron éxito |
1 | la ejecución terminó pero uno o más locales fallaron |
2 | no se pudo ejecutar: un error de toda la ejecución (configuración, origen, formato, proveedor o bloqueo) o un error de uso |
Que falle un locale no es fatal: la ejecución termina, sale con 1 y el detalle por locale queda en el resumen.
Relacionado
- Cómo funciona explica la canalización de leer, comparar, traducir y escribir.
- La caché explica qué omite
--no-cachey cómo se acota la reutilización. - Seguridad de la traducción cubre las comprobaciones de integridad y la cola de revisión.
verbatra diffprevisualiza las mismas claves pendientes en modo de solo lectura.- CI y códigos de salida muestra cómo ramificar sobre estos códigos.