Как сохранить проверенные переводы при обновлениях

Храните исходный текст и принятый перевод вместе как базовые версии, выбирайте подходящий режим обновления и проверяйте, что именно изменилось.

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

Само слово «инкрементальный» ещё не описывает такую защиту. Сохраняйте предыдущий исходный текст и принятый перевод, выбирайте правила обновления для вызывающего инструмента и проверяйте фактические различия. Если нужно внести конкретное исправление в перевод, используйте обновление одного ключа. Если отправленная задача остановилась, начните с восстановления.

Зафиксируйте, что нужно изменить, а что — сохранить #

Рассмотрим пример исходного текста:

json
{
  "retention": "Reports remain available for 30 days.",
  "support": "Contact support",
  "productName": "ExampleApp"
}

Владелец исходного текста меняет срок хранения на 60 дней. Сохраните предыдущую и новую версии исходного текста, а также проверенный перевод. Срок в переводе должен измениться, а принятая формулировка support — остаться прежней. Оставить productName в точности как в исходном тексте и сохранить проверенную фразу в переводе — разные требования.

Сохраните последнюю принятую версию перевода, включая локальные правки, внесённые после скачивания, и их обоснование. Базовая версия на сервере и перевод в рабочем дереве уже могут различаться.

Для изменений исходного текста используйте обычное планирование по разнице версий #

В текущей версии CLI обычный вызов lingo push --wait планирует изменения на основе сохранённого состояния исходного текста и переводов. Храните конфигурацию, исходный текст, принятые переводы и .lingo/lock.json в системе контроля версий. Удаление Lockfile меняет планирование — это не просто обновление состояния.

--backfill-missing создаёт недостающие файлы переводов, но не заполняет каждый отсутствующий или изменённый ключ в существующих файлах. Шаблоны исходных файлов, переданные позиционными аргументами, ограничивают область планирования и меняют правила повторного использования переводов. --force заново создаёт выбранные переводы в отдельных файлах и может заменить принятый текст. При этом общие каталоги XCStrings по-прежнему могут повторно использовать встроенные переводы. Прежде чем запрашивать замену, выберите подходящий вариант по справочнику Push.

Перед масштабным запуском проверьте область изменений и при необходимости выполните предварительную оценку. После получения результатов сравните изменённое значение и соседние принятые значения. Проверяйте, сохранились ли переводы, по результату, а не по названию запуска.

Различайте блокировку исходного текста и сохранение перевода #

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

Управление ключами зависит от формата. Исключение ключа из результата — ещё один отдельный механизм. Если факты в исходном тексте изменились, соответствующее значение не стоит сохранять безусловно: так можно оставить устаревший смысл.

Согласуйте локальные исправления при получении результатов #

Сохраните существующие исправления перед отправкой обновления. В ходе обновления может быть заменена именно та версия перевода, которую зафиксировал push. Чтобы обнаружить правки, внесённые после отправки, не указывайте --wait, а затем проверьте lingo pull --dry-run. Pull сравнивает локальные переводы с зафиксированной версией и сохранёнными хешами и может отказаться перезаписывать более поздние правки. При прямом скачивании из push --wait такая повторная проверка не выполняется.

При конфликте сравните локальное исправление, зафиксированный перевод и полученный результат с соответствующими версиями исходного текста. Если исправление по-прежнему актуально, сохраните его в ходе обычной проверки. Используйте lingo pull --force только после того, как сохраните локальную работу и осознанно выберете замену. Принудительный режим обходит защиту, но не определяет, какая формулировка верна.

Для общих каталогов Apple сохраняйте весь файл и проверяйте локали, которых изменения не касались. Не удаляйте файл с исходным текстом и несколькими языками так, будто это лишь файл перевода, который можно без последствий удалить.

Примите новую базовую версию после проверки #

В этом примере проверьте срок в 60 дней в новом переводе, сохранённое значение support и ожидаемое поведение productName. Проверьте переменные и структуру в среде выполнения, где используется перевод. Сравнение версий показывает изменения, а языковая проверка определяет, верно ли новое утверждение.

Сохраните принятый перевод вместе с соответствующей версией исходного текста как следующую базовую версию. Если исправление должно повлиять на дальнейшие инструкции, отдельно решите, нужно ли изменить глоссарий или правило. Не рассчитывайте, что одна принятая правка научит движок локализации новому правилу.