Texto plano
Traduce un archivo de texto línea por línea para que cada línea del original conserve su posición en la traducción.
Los archivos de texto plano, como las descripciones para tiendas de aplicaciones y las notas de la versión, no contienen marcado ni claves. El procesador de archivos txt traduce cada línea por separado y coloca la traducción en su lugar, de modo que el archivo de destino tenga el mismo número de líneas que el original.
Líneas y unidades #
Por ejemplo:
Plan your trips offline.
• Download maps for any region
• Share routes with friendsCada línea con texto se convierte en una unidad de traducción cuya clave es el número de línea. En este ejemplo se traducen las líneas 1, 3 y 4. Las líneas en blanco o que solo contienen espacios o tabulaciones no constituyen una unidad y se copian tal cual.
Los espacios y las tabulaciones al principio y al final de cada 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 #
Al generar la salida, se sustituye el texto de cada línea del original actual y se conserva todo lo demás byte a 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 el mismo número 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 interiores se sustituyen por un único espacio, de modo que la traducción nunca añade líneas. Si una traducción está vacía, falla la generación de la salida para ese idioma.
La reutilización depende de que no cambien ni el texto de la línea ni su posición en el archivo, como ocurre con los segmentos de SubRip. Cambiar la sangría de una línea no obliga a traducirla de nuevo. Cuando se añaden 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 se repite se vuelven a traducir. Si el número de líneas del archivo de destino no coincide con el del original anterior, no se puede reutilizar ningún texto de ese archivo. Por eso, conserva el original anterior junto con su traducción aceptada.
Configura y comprueba el texto #
La CLI y la GitHub App deducen txt a partir de .txt. Un archivo .txt solo puede corresponder a una entrada de archivos cuyo patrón termine en .txt, como metadata/en/*.txt, o que tenga definido "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; aun así, una entrada posterior que especifique .txt puede seleccionarlos. Del mismo modo, una entrada amplia con "format": "txt" omite las imágenes y otros archivos que acompañan al texto. Usa Configuración de la CLI o GitHub para seleccionar los 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, de modo 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 necesite reordenar una frase. Comprueba la traducción donde se vaya a utilizar el texto: una ficha de una tienda o un campo con un límite de longitud pueden rechazar una traducción más larga que el original.