Traduce tu primer archivo
Crea un catálogo de origen, descarga los archivos de destino en alemán y francés y traduce un cambio posterior en el origen.
Esta guía te lleva paso a paso por la configuración, traducción y descarga de un archivo JSON en inglés. Al terminar, tendrás los archivos de destino en disco y una base para futuras modificaciones. Si prefieres que un agente de programación se encargue de la configuración, consulta Configurar con un agente de programación.
Usa un directorio de proyecto pequeño con Node.js y npm disponibles. También necesitas una cuenta de Lingo.dev, permiso para traducir con un motor de localización habilitado y cuota suficiente en tu cuenta para realizar el trabajo.
Instala e inicia sesión #
npm install --global @lingo.dev/cli
lingo --version
lingo loginAl iniciar sesión, se abre el navegador. Si usas un ejecutor no interactivo, proporciona LINGO_API_KEY mediante su almacén de secretos. Una clave de entorno tiene prioridad sobre las credenciales de inicio de sesión guardadas, así que elimina cualquier clave que las sustituya por error antes de iniciar sesión como otra persona.
Crea el origen #
Crea un directorio locales y guarda lo siguiente como locales/en.json:
{
"checkout": {
"title": "Review your order",
"submit": "Place order"
}
}Desde la raíz del proyecto, ejecuta:
lingo init --source en --targets de,fr --files 'locales/en.json' --yes
lingo linkinit escribe .lingo/config.json y añade un bloque de Lingo.dev a AGENTS.md para que los agentes de programación sepan que deben leer las guías para agentes de la CLI; usa --no-agents-md para omitir este paso. link te permite seleccionar la organización y el motor de localización, o crearlos si tu nivel de acceso lo permite. El motor de localización proporciona los modelos y las directrices lingüísticas; su ID se guarda en la configuración del proyecto, mientras que tu credencial se guarda por separado.
Abre la configuración antes de continuar. Debe indicar en como origen, de y fr como destinos, y locales/en.json como archivo de origen. Comprueba también los ID de la organización y del motor de localización, especialmente si trabajas con una copia o una bifurcación del proyecto.
Traduce y descarga #
lingo push --backfill-missing --waitLa operación de completado solicita los archivos de destino que faltan. --wait espera y descarga los resultados cuando están listos. Un primer envío normal sin un Lockfile almacena el origen en lugar de solicitar esta traducción inicial.
No modifiques los archivos de destino mientras el comando espera: esta vía de descarga directa no realiza la nueva comprobación de conflictos con los cambios locales que hace el comando de descarga independiente. Si la ejecución queda pendiente de revisión o indica fallos, comprueba su estado antes de darla por terminada.
Abre locales/de.json y locales/fr.json. Comprueba que las dos claves de checkout siguen presentes y lee los valores traducidos. Si no puedes evaluar un idioma de destino, recurre a una persona cualificada para revisarlo o a una medición adecuada. Al integrar los archivos con una aplicación, cárgalos también mediante su cargador de recursos habitual.
Revisa .lingo/lock.json junto con las diferencias de los archivos de origen y destino. Incluye los archivos aceptados, la configuración y el estado de referencia en el mismo commit. Sin --wait, ejecuta lingo pull más adelante desde el mismo checkout y equipo para descargar la última ejecución registrada localmente.
Actualiza el origen #
Cambia un valor o añade una clave en locales/en.json y, después, ejecuta:
lingo push --waitLa actualización normal compara los cambios del origen con el estado de referencia guardado. La operación de completado sirve para los archivos que faltan, no para las claves nuevas de un archivo de destino que ya existe.
Para otros tipos de recursos o estructuras, consulta Configuración y Formatos. En YAML y Android XML debes seleccionar el formato explícitamente. Para extraer llamadas del código fuente de React, continúa con la guía de inicio rápido de React; selecciona su catálogo JSONC en la configuración en lugar de dar por hecho que este archivo JSON de ejemplo lo selecciona.