Formatos
Encuentra el procesador de archivos que traduce tu texto sin alterar la estructura que necesita tu aplicación.
Un archivo de idioma contiene mucho más que palabras. Sus claves vinculan los mensajes con el código, sus marcadores de posición admiten valores de la aplicación y su estructura indica al framework cómo cargar el resultado. Un documento añade encabezados, enlaces, ejemplos y metadatos. Al traducir archivos, hay que cambiar el idioma sin perder esas conexiones.
Lingo.dev utiliza un procesador de formato para seleccionar el texto traducible y reconstruir el resultado. Elige el procesador según lo que represente el archivo. Tanto un catálogo de Rails como una especificación de OpenAPI pueden tener la extensión .yml, pero traducir todas sus cadenas provocaría problemas distintos en cada caso: la raíz de idioma de Rails debe cambiar, mientras que los identificadores de operaciones de una API deben mantenerse intactos.
Encuentra tu formato #
| Origen | Tipo de procesador | Referencia |
|---|---|---|
| Catálogo JSON anidado | json | JSON |
| JSON con comentarios de contexto | jsonc | JSONC |
| Catálogo YAML | yaml | YAML |
| YAML con una única raíz de idioma | yaml-root-key | YAML con raíz de idioma |
| Módulo estático de idioma en TypeScript | typescript | TypeScript |
| Array estático de idioma en PHP | php | PHP |
| Documento Markdown | md | Markdown |
| Markdown con componentes JSX | mdx | MDX |
| Documento Markdoc | markdoc | Markdoc |
| YAML de OpenAPI 3.x | yaml-openapi | OpenAPI |
| XML de recursos de Android | android | Android |
| Paquete de recursos de aplicación de Flutter | flutter | Flutter ARB |
| Tabla de cadenas de Apple | xcode-strings | Cadenas de Apple |
| Archivo plist de recursos de plurales de Apple | xcode-stringsdict | stringsdict de Apple |
| Catálogo de Apple con varios idiomas | xcode-xcstrings | Catálogos de cadenas de Apple |
| Catálogo PO de Gettext | po | Gettext |
| Documento de intercambio XLIFF | xliff | XLIFF |
| Subtítulos SubRip | srt | SubRip |
| Texto sin formato, traducido línea a línea | txt | Texto sin formato |
| Documento o fragmento HTML | html | HTML |
| Tabla CSV con una columna por idioma | csv | CSV |
| Paquete de recursos de propiedades de Java | properties | Propiedades de Java |
| Campos seleccionados de Payload CMS | payload | Payload |
La documentación de referencia describe los gestores de archivos existentes y sus límites de extracción y reconstrucción. La CLI y la GitHub App admiten los 22 tipos configurados que se enumeran arriba, salvo Payload. El formato HTML se detecta a partir de .html y .htm; el resultado conserva intacto el contenido de origen y, en un elemento <html> explícito, establece lang en el idioma de destino. Selecciona explícitamente la variante de YAML o el formato de Android que quieras usar en la configuración del repositorio. Al igual que los catálogos de cadenas de Apple, CSV conserva todos los idiomas en el archivo de origen. La guía de inicio rápido de la CLI te guía desde la configuración hasta la recuperación de un archivo; GitHub explica el flujo de trabajo gestionado del repositorio.
Las conexiones actuales con proveedores seleccionan y escriben contenido mediante sus propios contratos de integración.
Para traducir datos estructurados directamente, envía JSON en línea. Para subir archivos de origen y conservar sus formatos, sigue la guía Documentos de archivo. Ambas opciones utilizan el mismo ciclo de vida de los trabajos de traducción.
Conserva la versión de origen junto con sus traducciones #
La traducción incremental de archivos compara el contenido de origen actual con una versión anterior y utiliza la traducción existente que le corresponde. En conjunto, estos datos permiten conservar la redacción aceptada de los mensajes que no han cambiado y traducir los nuevos o modificados.
Las claves hacen que esa comparación resulte útil: checkout.title y account.title pueden contener el mismo texto en inglés y aun así conservar traducciones distintas. Las posiciones en los arrays, los números de los bloques de subtítulos, las posiciones de las líneas de texto sin formato y la estructura del documento también intervienen al establecer las correspondencias. Mover un elemento o reorganizar un documento traducido puede alterar esas correspondencias, así que mantén las traducciones asociadas a la versión de origen a partir de la que se generaron.
La mayoría de los formatos generan un archivo independiente para cada idioma de destino. Los catálogos de cadenas de Apple, en cambio, integran los idiomas en el archivo de origen. Un artefacto de Payload o un catálogo de cadenas también puede contener algunos valores de destino y carecer de otros. Revisa las entradas de destino en sí; no te limites a comprobar si existe un archivo.
Controla por separado la selección de texto y el resultado #
Excluir texto de la traducción puede significar varias cosas. Un valor bloqueado del catálogo se toma del origen; un valor conservado se toma de la traducción existente; un valor ignorado puede desaparecer del resultado. El formato y la interfaz desde la que se realiza la llamada determinan qué controles están disponibles.
Utiliza los ámbitos de claves de la CLI para JSON/JSONC, YAML, YAML con raíz de idioma, PHP y TypeScript. Una actualización parcial conserva la redacción de la traducción existente fuera de la selección, pero el tratamiento de las entradas que solo existen en el origen y de las posiciones en los arrays depende del formato. Revisa el resultado completo con ayuda de la referencia del formato correspondiente.
Los metadatos de contexto también tienen un comportamiento específico. Un comentario @context de JSONC describe el siguiente valor de cadena. Un @message.description de ARB describe su mensaje. En Gettext, msgctxt distingue los mensajes y aporta contexto. Los comentarios normales pueden conservarse durante la reconstrucción sin convertirse en instrucciones de traducción. Las anotaciones @src y @orphan de React pertenecen a su flujo de trabajo de mantenimiento del catálogo.
Una vez obtenido el archivo, cárgalo en el sistema que lo utiliza. Comprueba el idioma seleccionado, las variables, las formas de plural, los enlaces y los datos protegidos, además del significado del texto traducido. Las guías de aplicaciones te ayudan a completar ese trabajo para aplicaciones web, recursos nativos y contenido estático.