纯文本

逐行翻译文本文件,让译文与源文本的每一行一一对应。

应用商店描述、发行说明等纯文本文件没有标记,也没有键。txt 文件处理器会逐行独立翻译,并将译文写回原位,确保目标文件与源文件的行数一致。

行与翻译单元 #

例如:

text
Plan your trips offline.

  • Download maps for any region
  • Share routes with friends

每个包含文本的行都会成为一个翻译单元,以行号作为键。本例中,第 1、3、4 行会被翻译。空行以及仅含空格或制表符的行不构成翻译单元,会原样复制。

行首和行尾的空格及制表符不计入翻译单元,因此缩进和行尾空格在翻译后仍会保留。只有中间的文本会被翻译。

重建输出 #

生成输出时,会替换当前源文件中每一行的文本,其余内容则逐字节保留:空行、缩进、每行各自的行结束符(LF 或 CRLF,也支持混用),以及文件末尾是否有换行符。因此,目标文件与源文件的行数始终一致。

译文前后的空格和换行符会被移除,内部的换行符则会替换为单个空格,确保译文不会增加行数。如果译文为空,该语言区域的输出将无法组装。

与 SubRip 字幕条目一样,译文复用取决于行文本是否保持不变及其在文件中的位置。仅更改某行的缩进,无需重新翻译。添加或删除行时,文本在文件中仅出现一次的行会保留原有译文;文本出现多次的行则会重新翻译。如果目标文件的行数与上一版源文件不同,其中的文本就无法复用,因此请将上一版源文件与其已接受的目标文件配对保存。

配置并检查文本 #

CLI 和 GitHub App 会根据 .txt 推断出 txt。.txt 文件只会匹配模式以 .txt 结尾(如 metadata/en/*.txt)或设置了 "format": "txt" 的文件条目;设置了 "format": "txt" 的条目则只会选择 .txt 文件。docs/en/**/* 这类宽泛模式会跳过 .txt 文件,因此 LICENSE.txt 或 requirements.txt 等文件不会被翻译;后续明确指定 .txt 的条目仍可选中这些文件。同样,设置了 "format": "txt" 的宽泛条目也会跳过图片和文本以外的其他文件。文件选择方式请参阅 CLI 配置或 GitHub。CLI 键范围功能不可用,因为行号代表位置,而非稳定的键。

每一行都作为独立的翻译单元处理,因此跨多行的段落会逐行翻译。如果目标语言需要调整句子语序,请将每个段落放在一行内。请在文本的实际使用位置检查译文:商店详情页或有长度限制的字段可能不接受比源文本更长的译文。