Texte brut
Traduisez un fichier texte ligne par ligne en conservant la position de chaque ligne du fichier source.
Les fichiers en texte brut, comme les descriptions d’applications en boutique et les notes de version, ne contiennent ni balisage ni clés. Le gestionnaire de fichiers txt traduit chaque ligne séparément et replace la traduction au même endroit : le fichier cible compte ainsi autant de lignes que le fichier source.
Lignes et unités #
Par exemple :
Plan your trips offline.
• Download maps for any region
• Share routes with friendsChaque ligne contenant du texte devient une unité de traduction, avec son numéro de ligne pour clé. Ici, les lignes 1, 3 et 4 sont traduites. Une ligne vide ou ne contenant que des espaces ou des tabulations ne constitue pas une unité et est copiée telle quelle.
Les espaces et les tabulations en début et en fin de ligne restent en dehors de l’unité : l’indentation et les espaces de fin de ligne sont donc conservés lors de la traduction. Seul le texte situé entre eux est traduit.
Sortie reconstruite #
La sortie remplace le texte de chaque ligne du fichier source actuel et conserve tout le reste à l’octet près : les lignes vides, l’indentation, la fin de ligne propre à chaque ligne (LF ou CRLF, même lorsque les deux coexistent), ainsi que la présence ou l’absence d’un saut de ligne à la fin du fichier. Le fichier cible compte donc autant de lignes que le fichier source.
Les espaces et les sauts de ligne qui entourent une traduction sont supprimés, et tout saut de ligne à l’intérieur est remplacé par un seul espace. Une traduction n’ajoute donc jamais de ligne. Une traduction vide fait échouer l’assemblage de la sortie pour la langue concernée.
La réutilisation repose sur le texte inchangé d’une ligne et sur sa position dans le fichier, comme pour les blocs de sous-titres SubRip. Modifier l’indentation d’une ligne ne nécessite pas de la retraduire. Lorsque des lignes sont ajoutées ou supprimées, une ligne dont le texte n’apparaît qu’une fois dans le fichier conserve sa traduction, tandis qu’une ligne dont le texte apparaît plusieurs fois est retraduite. Un fichier cible dont le nombre de lignes diffère de celui du fichier source précédent ne fournit aucun texte réutilisable : conservez donc le fichier source précédent avec le fichier cible accepté correspondant.
Configurer et vérifier le texte #
La CLI et la GitHub App déduisent txt à partir de .txt. Un fichier .txt ne peut être sélectionné que par une entrée de fichiers dont le motif se termine par .txt, comme metadata/en/*.txt, ou qui définit "format": "txt". Une entrée avec "format": "txt" ne sélectionne que les fichiers .txt. Un motif large comme docs/en/**/* ignore les fichiers .txt : les fichiers comme LICENSE.txt ou requirements.txt ne sont donc pas traduits. Une entrée ultérieure qui désigne .txt peut toutefois les sélectionner. De même, une entrée large avec "format": "txt" ignore les images et les autres fichiers présents aux côtés des fichiers texte. Consultez Configuration de la CLI ou GitHub pour sélectionner les fichiers. La sélection par clé n’est pas disponible dans la CLI, car les numéros de ligne indiquent des positions et ne sont pas des clés stables.
Chaque ligne est traduite comme une unité distincte : un paragraphe réparti sur plusieurs lignes est donc traduit ligne par ligne. Gardez chaque paragraphe sur une seule ligne lorsque la langue cible nécessite de réorganiser une phrase. Vérifiez le texte cible là où il est utilisé : une fiche de boutique ou un champ soumis à une limite de longueur peut refuser une traduction plus longue que la source.