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 #

OrigenTipo de manejadorReferencia
Catálogo JSON anidadojsonJSON
JSON con comentarios de contextojsoncJSONC
Catálogo YAMLyamlYAML
YAML con una raíz de idiomayaml-root-keyYAML con raíz de idioma
Módulo estático de idioma en TypeScripttypescriptTypeScript
Arreglo estático de idioma en PHPphpPHP
Documento MarkdownmdMarkdown
Markdown con componentes JSXmdxMDX
Documento MarkdocmarkdocMarkdoc
YAML de OpenAPI 3.xyaml-openapiOpenAPI
XML de recursos de AndroidandroidAndroid
Paquete de recursos de aplicación de FlutterflutterFlutter ARB
Tabla de cadenas de Applexcode-stringsCadenas de Apple
Archivo plist de recursos de plural de Applexcode-stringsdictstringsdict de Apple
Catálogo de Apple para varios idiomasxcode-xcstringsCatálogos de cadenas de Apple
Catálogo PO de GettextpoGettext
Documento de intercambio XLIFFxliffXLIFF
Subtítulos SubRipsrtSubRip
Texto sin formato, traducido línea por líneatxtTexto sin formato
Documento o fragmento HTMLhtmlHTML
Tabla CSV con una columna por idiomacsvCSV
Paquete de recursos de propiedades de JavapropertiesPropiedades de Java
Campos seleccionados de Payload CMSpayloadPayload

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.