Lockfile в CLI v0

Узнайте, как базовое состояние исходного текста в старой версии помогает отслеживать необработанные изменения и восстанавливать состояние, не скрывая незавершённые переводы.

i18n.lock позволяет v0 отличать неизменённый исходный текст от текста, который нужно перевести. Храните этот файл вместе с исходным текстом и принятыми переводами, которые он описывает. Он не фиксирует каждую ручную правку перевода и не подтверждает его правильность.

Что хранится в файле #

В lingo.dev@0.138.10 это YAML-файл с version: 1 и отображением checksums. Каждый внешний раздел хранит хеш обработанного шаблона пути, а его записи сопоставляют ключи исходного текста с контрольными суммами исходных значений на основе MD5. Предоставьте CLI управлять этими записями — не создавайте их вручную.

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

Чем перевод отличается от замены базового состояния #

ОперацияЧто делает
lingo runПереводит вычисленные изменения и обновляет состояние исходного текста.
lingo run --forceЗаново создаёт выбранный результат, не опираясь на обычный набор изменений.
lingo lockfileДобавляет недостающие разделы состояния исходного текста, не меняя уже заполненные.
lingo lockfile --forceЗаменяет контрольные суммы исходного текста по текущим файлам, не переводя целевые тексты.
lingo run --frozenПроверяет синхронизацию без перевода, но сначала создаёт базовое состояние, если его нет.

Допустим, английский текст изменился после принятия французского перевода. Замена контрольной суммы с помощью lockfile --force фиксирует новый английский текст как базовое состояние, хотя французский перевод всё ещё может передавать старый смысл. Поэтому пересоздание базового состояния — не стандартный способ устранить ошибку синхронизации.

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

Чтобы согласовать изменение исходного текста для нескольких локалей:

  1. Не меняйте ревизию исходного текста и сохраняйте i18n.lock, пока хотя бы один затронутый перевод не завершён. Используйте lingo run для обычного обновления всего проекта или описанные в документации запуски с ограниченной областью, если переводы нужно доработать и проверить отдельно.
  2. Проверьте переводы для всех локалей, которых касается замена контрольных сумм исходного текста, включая те, которые не затронул последний ограниченный запуск. Устраните ошибки и согласуйте принятые ручные правки с этим исходным текстом. Если хотя бы один перевод всё ещё устарел или вызывает сомнения, отложите обновление общего базового состояния.
  3. Если ограниченные запуски не изменили существующее базовое состояние, а все затронутые переводы уже приняты, запустите lingo lockfile --force из нужного корня проекта. Эта команда заменяет контрольные суммы исходного текста без перевода, поэтому не используйте её, чтобы пропустить предыдущую проверку. Не рассчитывайте, что последний выбранный параметр целевой локали ограничит область этой замены.
  4. Проверьте изменения в Lockfile и сохраните одним коммитом точную ревизию исходного текста, все соответствующие принятые переводы и i18n.lock. Позже вы сможете с помощью lingo run --frozen проверить синхронизацию с этим согласованным базовым состоянием, но не актуальность или качество переводов.

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

Как восстановить отсутствующее состояние или устранить конфликт #

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

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

Старый механизм исправления YAML сохраняет последнюю из повторяющихся записей и сообщает об удалениях. Это устраняет дублирование записей в синтаксисе, но не определяет, в какой ветке формулировка верна. Проверьте конфликтующие значения, прежде чем сохранить исправленный файл в коммите вместе с принятыми переводами.