Formatos
Encuentra el manejador de archivos que traduce tu texto sin alterar la estructura que necesita tu aplicación.
Un archivo de idioma contiene más que palabras. Sus claves vinculan los mensajes con el código, sus marcadores de posición reciben valores de la aplicación y su estructura le indica al marco de trabajo cómo cargar el resultado. Un documento también incluye encabezados, enlaces, ejemplos y metadatos. Traducir archivos implica cambiar el idioma sin perder esas conexiones.
Lingo.dev usa un manejador de formato para seleccionar el texto que se puede traducir y reconstruir el resultado. Elige el manejador según lo que representa el archivo. Tanto un catálogo de Rails como una especificación de OpenAPI pueden terminar en .yml, pero traducir todas sus cadenas causaría problemas distintos en cada caso: la raíz de idioma de Rails debe cambiar, mientras que los identificadores de operación de una API deben permanecer intactos.
Encuentra tu formato #
| Origen | Tipo de manejador | Referencia |
|---|---|---|
| Catálogo JSON anidado | json | JSON |
| JSON con comentarios de contexto | jsonc | JSONC |
| Catálogo YAML | yaml | YAML |
| YAML con una raíz de idioma | yaml-root-key | YAML con raíz de idioma |
| Módulo estático de idioma en TypeScript | typescript | TypeScript |
| Arreglo 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 plural de Apple | xcode-stringsdict | stringsdict de Apple |
| Catálogo de Apple para 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 por 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 |
Las referencias describen los manejadores 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, excepto Payload. El formato HTML se detecta a partir de .html y .htm; el archivo de salida conserva intacto el contenido de origen no modificado y asigna el idioma de destino al lang de un elemento <html> explícito. 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 acompaña desde la configuración hasta la recuperación de un archivo; GitHub explica el flujo de trabajo administrado 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 cargar archivos fuente y conservar sus formatos, sigue la guía Documentos de archivo. Ambas opciones usan el mismo ciclo de vida de los trabajos de traducción.
Conserva la revisión del archivo fuente junto con sus traducciones #
La traducción incremental de archivos compara el contenido fuente actual con una versión anterior y usa la traducción de destino existente que le corresponde. Juntas, estas entradas permiten conservar la redacción aceptada de los mensajes sin cambios y traducir los mensajes nuevos o modificados.
Las claves hacen útil esa comparación: checkout.title y account.title pueden contener el mismo texto en inglés y aun así conservar traducciones distintas. Las posiciones en los arreglos, 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 en la correspondencia. Mover un elemento o reorganizar un documento traducido puede cambiar esa correspondencia, así que mantén las traducciones de destino vinculadas a la revisión del archivo fuente a partir de la cual se generaron.
La mayoría de los formatos generan un archivo independiente para cada idioma de destino. En cambio, los catálogos de cadenas de Apple integran los idiomas en el archivo fuente. Un artefacto de Payload o un catálogo de cadenas también puede contener algunos valores de destino y aún tener otros pendientes. Revisa las entradas de destino en sí, no solo la existencia del archivo.
Controla por separado la selección de texto y la salida #
Excluir texto de la traducción puede significar varias cosas. Un valor bloqueado del catálogo proviene del contenido fuente; un valor conservado proviene de la traducción de destino existente; un valor ignorado puede desaparecer de la salida. El formato y la interfaz desde la que se realiza la llamada determinan qué controles están disponibles.
Usa 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 destino existente fuera de la selección, pero el tratamiento de las entradas que solo existen en el contenido fuente y de las posiciones en los arreglos 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. El msgctxt de Gettext distingue los mensajes y aporta contexto. Los comentarios comunes 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.
Después de recuperar un archivo, cárgalo en el sistema que lo usa. Además del significado de la traducción, verifica el idioma seleccionado, las variables, las formas de plural, los enlaces y los datos protegidos. Las guías de aplicación completan este trabajo para aplicaciones web, recursos nativos y contenido estático.