Docs / Ayuda
Página traducida automáticamente
Preguntas frecuentes
Respuestas cortas a las preguntas que más surgen al usar verbatra, desde lo que cuesta una ejecución hasta lo que deberías confirmar en el repositorio.
Respuestas cortas con un enlace a la página que tiene los detalles. Para los mensajes de error, consulta Solución de problemas y Códigos de error.
¿Cómo controlo el coste?
Las ejecuciones son incrementales, así que solo las claves que faltan o que cambiaron llegan al
proveedor, y volver a ejecutar un proyecto sin cambios no cuesta nada. verbatra translate --estimate dimensiona una ejecución sin llamar a un proveedor, y --max-tokens o maxTokens en la
config la limitan. Consulta Estimar el coste.
¿Cuánto cuesta realmente una ejecución?
Poco: 400 claves a 3 locales con gemini-2.5-flash suman unos 72.000 tokens, que valoras con la
tarifa actual de tu proveedor, y las ejecuciones siguientes solo pagan por los textos que
cambiaste. Cómo estimar una ejecución, dónde publica cada proveedor sus tarifas y cómo calibrar con
tu propio proyecto están en Estimar el coste.
¿Con qué proveedor empiezo?
Con Gemini, porque su nivel gratuito de API te deja traducir un proyecto entero sin coste, y
cambiar después es editar un id. Mantén los textos confidenciales fuera del nivel gratuito:
consulta
Tratamiento de datos y privacidad.
Todos los proveedores se comparan en Proveedores.
¿Puedo usar un modelo local?
Sí: el proveedor openai-compatible apunta verbatra a cualquier servidor que hable la API de chat
de OpenAI, como LM Studio, Ollama o vLLM, normalmente sin clave. Sin ningún modelo de lenguaje,
libretranslate usa un servidor LibreTranslate propio. Consulta
Proveedores.
¿Qué idiomas admite verbatra?
Cualquier idioma que admita tu proveedor, escrito como un código BCP 47 válido como pt-BR o
zh-Hant. DeepL y Google Cloud Translation tienen listas fijas; los proveedores LLM no tienen
ninguna. Consulta Soporte de idiomas.
¿Cómo conservan las claves su orden?
Las claves existentes conservan su posición y las nuevas se añaden en el orden de la fuente, así que un archivo traducido da un diff limpio. Consulta Formatos.
¿Por qué una traducción quedó marcada para revisión?
Una heurística de revisión encontró algo que merece una segunda mirada, como una traducción igual a su fuente, y la marcó sin retenerla. Cada código de motivo aparece en Motivos de revisión.
¿Funciona verbatra en un monorepo?
Sí. La búsqueda de la config sube desde el directorio de trabajo y se detiene en el .git más
cercano, así que un paquete encuentra su propia config y la raíz la de la raíz; --cwd y
--config apuntan a cualquier otro sitio. Consulta Archivo de configuración.
¿Qué debo confirmar?
Confirma tus archivos de locale, verbatra.lock.json y verbatra.provenance.json; nunca .env,
.env.local, .verbatra-local/ ni verbatra.cache.json, que verbatra init añade a
.gitignore. Consulta El archivo de bloqueo.
¿Cómo lo retraduzco todo?
Borra el archivo de locale y ejecuta verbatra translate: entonces falta cada clave y se traduce
de nuevo. Borrar el archivo de bloqueo no sirve, porque sin línea base las traducciones existentes
cuentan como actuales. Para una sola clave, usa la acción de retraducir de Studio o
retranslateEntry.
¿Usar la CLI implica instalar el SDK?
Sin paso extra: @verbatra/cli depende de @verbatra/sdk, así que viene con ella. Solo
@verbatra/studio y @verbatra/mcp son instalaciones aparte y opcionales.
¿Dónde viven las claves de API?
Solo en variables de entorno, que la CLI también lee de
.env.local y .env. La config rechaza claves desconocidas para
que ningún secreto acabe en un archivo confirmado. Consulta Proveedores.
¿verbatra envía mis textos a algún sitio?
Solo al proveedor que configuras, y solo cuando un comando traduce; no hay telemetría. Con
provider: { id: "none" } nada sale de la máquina. Consulta
Tratamiento de datos y privacidad.
¿Qué comprueba realmente verbatra doctor?
La configuración de una sola pasada, sin una llamada de traducción y sin leer el valor de una clave
salvo que pases --live, que la envía para obtener la lista de idiomas del proveedor: la config, el
formato, el proveedor, la variable de la clave de API, la política de red, el archivo fuente y el
soporte de locales, más informes informativos sobre plurales, códigos de locale y estado de locale
sobrante. verbatra doctor tiene la tabla completa de comprobaciones.
¿Puede un agente de IA configurar o manejar verbatra por mí?
Sí, a través de cuatro superficies: un prompt de configuración para agentes de código
(Configurar con un agente de IA), la salida --json para tus propios bucles
(Recetas para agentes y scripts), herramientas WebMCP en una pestaña abierta
de Studio (Maneja Studio con un agente del navegador) y un servidor
MCP por stdio (verbatra mcp). Studio y el servidor MCP solo gastan en un proveedor
tras un flag --allow-spend; en el bucle --json, un translate real gasta al instante, así que tu
script o agente debe pedir antes el visto bueno de una persona.
¿Este sitio publica algo para agentes de IA y rastreadores?
Sí, tres archivos estáticos, generados en tiempo de build y siempre en inglés, sin importar qué locale estés viendo:
/llms.txt: un índice curado con el título y la descripción de cada página de la documentación, agrupado igual que la barra lateral, como enlaces en Markdown./llms-full.txt: toda la documentación en un solo archivo, el contenido renderizado de cada página concatenado en orden, para un agente que ingiere el contenido directamente en lugar de seguir enlaces./.well-known/ai.txt: una política de uso que les dice a los rastreadores de IA que este proyecto tiene licencia MIT y que rastrear, indexar y citar este contenido es bienvenido.
Los tres están enlazados desde la columna "Para agentes de IA" del pie de página.
¿El contenido de este sitio está traducido por IA?
En su mayor parte, por dos mecanismos distintos. El texto de la interfaz (etiquetas de navegación,
botones, el pie de página, el texto de la página de inicio, sus preguntas frecuentes) vive en
messages/en.json y sus hermanos de, es y fr; esos se traducen automáticamente con verbatra
mismo, contra el formato next-intl-json, a través del proveedor Gemini, ejecutando pnpm i18n
después de que cambie la fuente en inglés. Es el propio proyecto usando su propia herramienta
(dogfooding), y el workflow docs-i18n-check hace fallar un pull request cuyos archivos de locale
se han desviado de la fuente en inglés. La prosa de la documentación que estás leyendo ahora mismo,
cada guía y cada página de referencia incluida esta, es MDX con sufijo de locale (page.mdx,
page.de.mdx, page.es.mdx, page.fr.mdx) y también está traducida con IA, solo que fuera de esa
canalización automatizada: pnpm i18n solo traduce los formatos de archivo de locale estructurados,
nunca Markdown, así que nunca toca estas páginas. En su lugar, un agente de IA traduce cada página
de documentación en el mismo cambio que edita su fuente en inglés, así que los cuatro idiomas llegan
juntos; por eso cada página que no está en inglés muestra el aviso de traducción automática.
No todo sale tal cual de esos dos pasos: algunos textos, entre ellos partes de las páginas legales, se redactaron o corrigieron directamente en los archivos de locale. Las traducciones se revisan en la medida de lo posible, y no todos los textos traducidos los revisa una persona antes de publicarse, por lo que una traducción puede contener errores. La política de privacidad describe el mismo proceso.
Si algo en alemán, español o francés suena raro, abre un issue en cualquiera de los dos casos: en el texto de la interfaz, la corrección va a la fuente en inglés y se vuelve a traducir, o directamente al archivo de locale afectado; para la prosa de la documentación, edita el archivo MDX directamente y envía un pull request.
Editar en GitHub