Texto sin formato

Traduce un archivo de texto línea por línea y conserva cada línea del original en su lugar.

Los archivos de texto sin formato, como las descripciones para tiendas de aplicaciones y las notas de versión, no tienen marcado ni claves. El controlador de archivos txt traduce cada línea por separado y escribe la traducción en su lugar, de modo que el archivo de destino tenga la misma cantidad de líneas que el original.

Líneas y unidades #

Por ejemplo:

text
Plan your trips offline.

  • Download maps for any region
  • Share routes with friends

Cada línea con texto se convierte en una unidad de traducción identificada por su número de línea. En este ejemplo se traducen las líneas 1, 3 y 4. Una línea en blanco o que solo contiene espacios o tabulaciones no se considera una unidad y se copia tal cual.

Los espacios y las tabulaciones al principio y al final de una línea quedan fuera de la unidad, por lo que la sangría y los espacios finales se conservan al traducir. Solo se traduce el texto que queda entre ellos.

Salida reconstruida #

La salida reemplaza el texto de cada línea del archivo original actual y conserva todo lo demás byte por byte: las líneas en blanco, la sangría, el terminador de cada línea (LF o CRLF, incluso si se combinan ambos) y la presencia o ausencia de un salto de línea al final del archivo. Así, el archivo de destino tiene la misma cantidad de líneas que el original.

Se eliminan los espacios y los saltos de línea al principio y al final de cada traducción, y los saltos de línea internos se reemplazan por un solo espacio cada uno. Así, una traducción nunca agrega líneas. Si una traducción está vacía, no se puede generar la salida para ese idioma.

La reutilización depende de que el texto de cada línea no haya cambiado y de su posición en el archivo, al igual que con los segmentos de SubRip. Cambiar la sangría de una línea no requiere volver a traducirla. Cuando se agregan o eliminan líneas, las líneas cuyo texto aparece una sola vez en el archivo conservan su traducción, mientras que aquellas cuyo texto aparece más de una vez se vuelven a traducir. Si el archivo de destino tiene una cantidad de líneas distinta de la del original anterior, no aporta texto reutilizable. Por eso, conserva el original anterior junto con su archivo de destino aceptado.

Configura y revisa el texto #

La CLI y la GitHub App infieren txt a partir de .txt. Un archivo .txt solo corresponde a una entrada de archivos cuyo patrón termina en .txt, como metadata/en/*.txt, o que establece "format": "txt". A su vez, una entrada con "format": "txt" selecciona únicamente archivos .txt. Un patrón amplio como docs/en/**/* omite los archivos .txt, por lo que archivos como LICENSE.txt o requirements.txt no se traducen; una entrada posterior que especifique .txt aún puede seleccionarlos. Del mismo modo, una entrada amplia con "format": "txt" omite las imágenes y los demás archivos que acompañan al texto. Usa Configuración de la CLI o GitHub para seleccionar archivos. La selección por claves de la CLI no está disponible, porque los números de línea indican posiciones, no claves estables.

Cada línea se traduce como una unidad independiente, por lo que un párrafo dividido en varias líneas se traduce línea por línea. Mantén cada párrafo en una sola línea cuando el idioma de destino requiera cambiar el orden de una oración. Revisa la traducción en el lugar donde se usa el texto: una ficha en una tienda o un campo con un límite de longitud puede rechazar una traducción más larga que el original.