Claves de traducción

Introducción

Una clave de traducción es un identificador único que conecta un fragmento de contenido con sus traducciones correspondientes en diferentes idiomas. Al configurar ciertos tipos de buckets, puedes utilizar estas claves para habilitar funciones específicas del bucket, como bloqueo de claves o ignorar claves.

Claves definidas por el usuario

En algunos formatos de archivo, las claves de traducción deben definirse explícitamente. Por ejemplo, en el siguiente archivo JSON, title, description y version son las claves de traducción:

{
  "title": "Hello, world!",
  "description": "A simple demo app",
  "version": "1.0.0"
}

Tienes control total sobre la nomenclatura de estas claves.

Claves generadas automáticamente

En algunos formatos de archivo, las claves de traducción se generan automáticamente según la estructura del archivo. Estos, por ejemplo, son ejemplos de claves generadas automáticamente para un archivo HTML:

• head/0/0
• head/1#content
• body/0/0
• body/1/0
• body/1/1/0

Para identificar una clave generada automáticamente para un fragmento específico de contenido, examina el archivo i18n.lock del proyecto.

Renombrar claves

Cuando refactorizas tu código y renombras claves para una mejor organización, Lingo.dev CLI detecta automáticamente que el contenido es el mismo y preserva las traducciones existentes. Esto evita trabajo innecesario de retraducción cuando solo cambia el identificador de la clave, no el contenido real.

Para obtener más información, consulta Renombrado de claves.

Bloqueo de claves

Algunos contenidos como identificadores técnicos, nombres de componentes o términos de marca deben permanecer idénticos en todos los idiomas. El bloqueo de claves te permite excluir claves específicas del procesamiento de traducción, copiando los valores de origen directamente a todos los archivos de destino.

Para obtener más información, consulta Bloqueo de claves.

Ignorar claves

El contenido de desarrollo, pruebas o interno a menudo no necesita traducción y no debería aparecer en archivos de producción. Ignorar claves excluye completamente estas claves del procesamiento de traducción, manteniéndolas fuera de los archivos de destino por completo.

Para obtener más información, consulta Ignorar claves.