Как писать исходный текст, который хорошо переводится

Что это такое

Писать для перевода — значит строить исходный текст так, чтобы переводчик или этап машинного перевода мог получить корректный результат без вопросов к автору и без препятствий со стороны кода. Руководство GNU gettext (см. источник) перечисляет правила для кода: хороший английский стиль, целые предложения, разделение по абзацам, форматные строки вместо конкатенации, подстановки вместо встроенных URL. Страница о множественных формах (см. источник) добавляет, что количества необходимо обрабатывать функцией множественного числа, а не самодельным file%s, поскольку число множественных форм в языках различается; она показывает языки с двумя, тремя и большим числом форм и правила заголовков вроде nplurals=3. Рекомендации Google по стилю для международной аудитории (см. источник) касаются прозы: единообразная терминология и структура предложений, отказ от разговорных выражений, идиом, юмора и сезонных отсылок.

Почему это важно

Порядок слов, род, правила множественного числа и длина предложений в языках различаются. Строку из фрагментов ("Deleted " + n + " file(s)") переводчик не может переставить или согласовать по формам; специфичную для английского идиому либо переведут буквально, либо заменят догадкой; у предложения, основанного на английском каламбуре, вообще нет текста перевода. Каждый такой случай оборачивается вопросом к автору или неверным переводом в рабочем продукте.

Как применять

• Одна строка на целое предложение или подпись; никогда не собирайте предложение из частей во время выполнения.
• Используйте именованные подстановки ({count} files in {folder}), чтобы переводчик мог менять их порядок; дайте переводчикам комментарий о содержимом каждой подстановки.
• Пропускайте любое количество через функцию множественного числа фреймворка, включая английский оригинал ("1 file", "2 files"); не пишите "file(s)".
• Фиксируйте терминологию: один термин из глоссария на понятие, чтобы срабатывало совпадение с памятью переводов.
• Предпочитайте короткие повествовательные предложения со стандартным порядком слов; избегайте цепочек существительных и неоднозначных местоимений ("it", "this") с неясным референтом.
• Исключайте идиомы, юмор, культурные и сезонные отсылки, а также примеры, предполагающие форматы одной страны; выводите даты, числа и валюты через форматирование с учётом локали, а не непосредственно в строке.
• Оставляйте место: перевод может быть длиннее оригинала, поэтому макеты и ширина столбцов не должны исходить из длины исходного текста.
• Механизмом инструмента помечайте в исходнике то, что нельзя переводить (названия продуктов, команды, код).

Подводные камни

Повторное использование одной строки в двух значениях ("Open" как глагол и как состояние). Предложения, разделённые между элементами интерфейса. Скриншоты со встроенным английским текстом. Косметические изменения исходных строк, которые делают недействительными все существующие переводы такой строки.