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 contenido de origen.

Esta guía te acompaña paso a paso en la configuración, traducción y descarga de un archivo JSON en inglés. Al terminar, tendrás los archivos en los idiomas de destino en el disco y una base para futuras ediciones. Para 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 una cuota de uso suficiente en la cuenta para realizar el trabajo.

Instala e inicia sesión #

sh
npm install --global @lingo.dev/cli
lingo --version
lingo login

Al 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 el inicio de sesión guardado, así que elimina cualquier clave que lo esté reemplazando por error antes de iniciar sesión como otra persona.

Crea el archivo de origen #

Crea un directorio locales y guarda lo siguiente como locales/en.json:

json
{
  "checkout": {
    "title": "Review your order",
    "submit": "Place order"
  }
}

Desde la raíz del proyecto, ejecuta:

sh
lingo init --source en --targets de,fr --files 'locales/en.json' --yes
lingo link

init escribe .lingo/config.json y agrega 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 omitirlo. 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 pautas de idioma; su ID se guarda en la configuración del proyecto, mientras que tu credencial se almacena por separado.

Abre la configuración antes de continuar. Debe indicar en como idioma de origen, de y fr como idiomas de destino y locales/en.json como archivo de origen. Revisa 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 #

sh
lingo push --backfill-missing --wait

El completado solicita los archivos de destino que faltan. --wait espera y descarga el resultado una vez terminado. Un primer envío normal sin un Lockfile establece el almacenamiento del contenido de origen en lugar de solicitar esta traducción inicial.

No modifiques los archivos de destino mientras el comando espera: esta descarga directa no realiza la comparación actualizada para detectar conflictos con cambios locales que hace el comando de descarga independiente. Si la ejecución queda pendiente de revisión o informa fallas, revisa ese estado antes de darla por terminada.

Abre locales/de.json y locales/fr.json. Confirma que las dos claves de checkout sigan presentes y lee los valores traducidos. Si no puedes evaluar un idioma de destino, recurre a una persona calificada para la revisión 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. Registra en un mismo commit los archivos aceptados, la configuración y la base de referencia. Sin --wait, ejecuta lingo pull más adelante desde el mismo checkout y equipo para descargar la última ejecución registrada localmente.

Actualiza el archivo de origen #

Cambia un valor o agrega una clave en locales/en.json y luego ejecuta:

sh
lingo push --wait

La actualización normal compara los cambios del contenido de origen con la base de referencia guardada. El completado sirve para archivos faltantes, no para claves nuevas dentro de un archivo de destino que ya existe.

Para otros tipos de recursos o estructuras, consulta Configuración y Formatos. YAML y Android XML requieren seleccionar el formato de forma explícita. 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 suponer que este archivo JSON de ejemplo lo selecciona.