Herramientas de desarrollo

Traduce archivos, llama a la API desde tu servidor y renderiza aplicaciones multilingües con paquetes de JavaScript.

La localización conecta dos tipos de código: el que genera las traducciones y el que las utiliza. Un servidor puede solicitar contenido traducido cuando cambia un registro. Un proceso de compilación puede recopilar archivos traducidos. Un componente de React puede leer un catálogo existente sin hacer ninguna solicitud de traducción.

Empieza por la parte que estés implementando. Cada sección incluye una primera tarea completa, seguida de los contratos necesarios para seguir trabajando.

API #

Utiliza la API cuando tu servidor ya disponga del contenido y deba decidir cuándo solicitar una traducción, dónde guardarla y cuándo utilizarla. Envía contenido JSON o archivos subidos como un trabajo de traducción, inícialo y recupera cada resultado de destino completado. El motor controla las etapas de traducción y revisión del trabajo.

La guía Haz tu primera solicitud envía un pequeño conjunto de datos y guarda los datos traducidos en local. Explica la credencial, la selección del motor de localización, los campos de la respuesta y las comprobaciones necesarias antes de conectar el proceso al almacenamiento de la aplicación.

CLI #

Utiliza la CLI cuando el contenido esté en archivos. Configura las rutas de origen y los idiomas de destino, envía el trabajo seleccionado y recupera los archivos de destino en tu proyecto. La CLI guarda versiones de referencia del contenido de origen para que las siguientes ejecuciones puedan procesar los cambios en lugar de tratar cada archivo como nuevo.

La guía Traduce tu primer archivo cubre la instalación, la autenticación, la configuración y la recuperación de archivos. La misma CLI permite extraer mensajes explícitos de React a catálogos; la extracción se realiza en local y no solicita traducciones.

JavaScript #

Los paquetes de JavaScript cubren los clientes de servidor, el renderizado de mensajes de React y el enrutamiento por idioma. Elige un cliente para las solicitudes de traducción o una biblioteca de renderizado para los mensajes que ya estén disponibles en la aplicación. El renderizado en el navegador no necesita una clave de la API de traducción.

La documentación de React incluye un ejemplo local para mostrar un primer mensaje, la carga de catálogos, las alternativas gramaticales, el texto enriquecido y la integración específica de cada framework. La negociación de URL y el texto traducido son responsabilidades independientes, por lo que la documentación de referencia sobre enrutamiento explica cómo mantener sincronizados el idioma seleccionado y los mensajes cargados.

Incorpora un proyecto existente #

La sección Formatos explica qué traduce y reconstruye cada procesador. Consulta también la lista de formatos de la herramienta que lo invoca: que un procesador esté disponible para una integración de servidor no significa que esté configurado como formato de archivo en la CLI.

Los proyectos que utilizan i18n.json o LingoDotDevEngine cuentan con documentación de referencia específica para CLI v0 y SDK v0. Mantén la versión instalada mientras planificas la migración; la configuración, el estado conservado y los valores de retorno pueden cambiar entre generaciones.

Para un asistente que trabaje con archivos locales o con la configuración de la cuenta, utiliza MCP. Para traducciones conectadas a un repositorio, un CMS o un centro de ayuda, utiliza Integraciones. Cada conexión define cómo se inicia el trabajo, con qué autoridad se ejecuta y dónde se devuelven los resultados.