Обычный текст

Переводите текстовый файл построчно, сохраняя каждую строку исходного текста на своём месте.

В обычных текстовых файлах, например в описаниях приложений для магазинов и примечаниях к выпуску, нет разметки и ключей. Обработчик файлов 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 относится только к записи files, у которой шаблон заканчивается на .txt, например metadata/en/*.txt, или задано "format": "txt". Запись с "format": "txt" выбирает только файлы .txt. Шаблон с широким охватом, например docs/en/**/*, пропускает файлы .txt, поэтому файлы вроде LICENSE.txt или requirements.txt не переводятся. Но их может выбрать следующая запись, в которой указано .txt. Запись с широким охватом и "format": "txt" тоже пропускает изображения и другие файлы, кроме текстовых. О выборе файлов см. в разделах Конфигурация CLI или GitHub. Область видимости ключей недоступна в CLI, потому что номера строк обозначают позиции, а не постоянные ключи.

Каждая строка переводится как отдельная единица, поэтому абзац, разбитый на несколько строк, переводится построчно. Если в целевом языке нужно менять порядок слов в предложении, размещайте каждый абзац на одной строке. Проверяйте перевод там, где он используется: страница приложения в магазине или поле с ограничением длины может не принять перевод, если он длиннее исходного текста.