|Labs
Agenda una demoPlataforma
React (Lingo Compiler)
Alpha
React (MCP)React (i18n)CLI anterior (v0)
Obsoleto

Lingo.dev CLI

  • Cómo funciona
  • Configuración
  • Inicio rápido
  • Monorepos

Configuración

  • Formatos compatibles
  • i18n.json
  • i18n.lock
  • Idiomas compatibles

Funciones

  • Traducciones existentes
  • Agregar idiomas
  • Sobrescrituras
  • Notas para traductores
  • Claves de traducción
  • Renombrado de claves
  • Bloqueo de claves
  • Ignorar claves
  • Preservación de claves
  • Extrae claves con IA

Rendimiento

  • Proyectos de gran escala
  • Procesamiento en paralelo
  • Estimación de costos

Retraducción

  • Retraducción automática
  • Retraducción
  • Eliminar traducciones

Esta documentación corresponde al CLI anterior (v0) y está obsoleta. El CLI actual es la v1. Consulta la documentación del CLI actual

Sobrescrituras

El CLI de Lingo.dev conserva las ediciones manuales en los archivos de destino. Cuando sobrescribes una traducción generada editando directamente el archivo de destino, el CLI mantiene tu cambio en las siguientes ejecuciones, siempre que el contenido de origen no haya cambiado.

Cómo funcionan las sobrescrituras#

El CLI rastrea las huellas del contenido de origen, no las del contenido de destino. Cuando editas manualmente una traducción en un archivo de destino, la huella del origen no cambia, así que el CLI considera que la clave ya está traducida y la omite.

1

El CLI genera una traducción

json
// locales/es.json (generated)
{ "greeting": "Bienvenido a nuestra plataforma" }
2

La sobrescribes manualmente

json
// locales/es.json (manually edited)
{ "greeting": "¡Bienvenido a nuestro espacio digital!" }
3

Las siguientes ejecuciones conservan tu sobrescritura

bash
npx lingo.dev@latest run
# Your custom translation remains unchanged

Cuándo se reemplazan las sobrescrituras#

Si el contenido de origen cambia, el CLI detecta una nueva huella y vuelve a traducir la clave, reemplazando tu sobrescritura:

json
// locales/en.json (source updated)
{ "greeting": "Welcome to our new platform" }

La nueva huella no coincide con la entrada del archivo de bloqueo, así que el CLI genera una traducción nueva para esta clave.

Cambio de nombre de claves#

El CLI conserva las traducciones incluso cuando cambias el nombre de las claves, siempre que el contenido siga siendo el mismo. El archivo de bloqueo rastrea tanto las huellas del contenido como las de las claves, lo que permite cambiar el nombre de las claves sin perder el trabajo de traducción.

Siguientes pasos#

Cambio de nombre de claves
Cambia el nombre de las claves sin perder traducciones
Retraducción
Fuerza la retraducción cuando la necesites
i18n.lock
Cómo el archivo de bloqueo registra el estado
Traducciones existentes
Integra tus archivos de traducción existentes

¿Te resultó útil esta página?

Max PrilutskiyMax Prilutskiy·Actualizado hace 5 días·1 min de lectura