Как безопасно обновить один ключ или термин
Переведите выбранную часть заново, сохраните соседний текст и проверьте и нужное исправление, и то, что должно остаться без изменений.
У точечного исправления два критерия успеха: выбранный текст стал лучше, а остальные принятые переводы остались без изменений. Сохраните текущий перевод и соответствующую версию исходного текста, чтобы проверить оба условия.
Это руководство поможет исправить конкретный ключ или термин. Для обычных изменений исходного текста см. сохранение переводов при обновлениях. Если работа уже отправлена, проверьте её состояние восстановления, прежде чем запрашивать новую.
Включите в сравнение соседний текст с принятым переводом #
Например, каталог может содержать:
{
"account": {
"invitation": "Approval is required before access is granted.",
"support": "Contact support"
}
}Допустим, исправить нужно только перевод account.invitation. Сохраните перевод и соответствующую версию исходного текста, включая принятый перевод account.support, который нужно оставить.
Выберите способ исправить формулировку #
Для точного разового исправления отредактируйте значение перевода напрямую, проверьте его в приложении и сохраните проверенный каталог в коммите. При обычных обновлениях исходного текста эта правка может сохраниться, пока исходный текст самого сообщения не меняется.
Перед повторной генерацией дайте системе перевода информацию, которая поможет получить другой результат. Добавьте утверждённый термин в глоссарий движка, исправьте повторяющуюся инструкцию в его правилах или уточните контекст JSONC для сообщения. Затем обновите затронутые ключи. Если исходный текст и инструкции не изменились, повторная генерация может дать ту же формулировку.
Выбирайте сообщения с нужным значением термина #
Прежде чем выбирать сообщения, определите значение термина. Например, «рабочее пространство» в продукте может означать общую область для работы над проектом, а в другом отрывке — физическое рабочее место. Укажите в глоссарии нужное значение в продукте и утверждённый командой перевод термина. Затем выберите только сообщения, где термин используется в этом значении. Подробнее об этом — в разделе Границы термина.
Выберите существующий ключ перевода с помощью CLI #
В настроенном проекте, где этот исходный JSON-файл находится по пути locales/en/account.json:
lingo push "locales/en/account.json" --key "account.invitation" --waitДля JSON --key заново генерирует выбранные единицы перевода, даже если исходный текст не изменился. Команда обновляет эти ключи для каждой настроенной локали, у которой уже есть файл перевода, и добавляет новые значения в этот файл вместо прежних.
Перед обновлением сохраните существующие исправления: перевод, зафиксированный этим push, может быть заменён в выбранных ключах. Чтобы обнаружить правки перевода, сделанные после отправки, не указывайте --wait и проверьте lingo pull --dry-run перед получением результатов. Об обработке конфликтов см. Классификация локальных правок при pull.
Обновление ключей не меняет базовую версию всего исходного текста — независимо от того, получены результаты с помощью push --wait или отдельного pull. Поэтому обычные изменения исходного текста, ожидающие отправки, по-прежнему попадут в следующий обычный push.
Шаблоны ключей поддерживают точные ключи, префиксы объектов и подстановочный знак *, заменяющий целый сегмент. auth.login может охватывать auth.login.title, но не auth.login_url. Заключайте шаблоны с подстановочными знаками в кавычки и повторяйте --key, чтобы задать несколько нужных шаблонов.
В JSONC, TypeScript и PHP обновление выбранной области работает так же. В YAML и YAML с локалями на корневом уровне выбранные переводы могут остаться без изменений. Для точного исправления отредактируйте перевод напрямую или сохраните принятые переводы перед повторной генерацией всего файла. В разделе Области видимости CLI описаны особенности форматов и правила записи ключей.
Найдите ключи или файлы, затронутые термином #
Найдите исходные сообщения, в которых термин используется в нужном значении, и проверьте их контекст. В команде выше укажите их ключи с помощью --key, если формат поддерживает такой выбор. Для форматов, требующих повторной генерации всего файла, сохраните принятые переводы и обновите затронутые исходные файлы, например:
lingo push 'docs/en/workspaces.md' --force --waitИспользуйте путь к исходному файлу, уже выбранному в конфигурации. Это заменит переводы этого файла для настроенных целевых локалей. Сравните переписанное сообщение или файл целиком, включая текст вокруг термина.
Проверьте исправления, неизменённый текст и результат в работе #
Для каждого изменённого пути перевода сравните результат с сохранённой версией. В примере приглашение должно по-прежнему требовать одобрения перед предоставлением доступа, а сообщение поддержки — совпадать с принятой базовой версией. Если соседний текст пропал или неожиданно изменился, проверьте выбранную область и базовую версию, прежде чем принимать результат.
Проверьте переменные и управление ключами: блокировка копирует исходный текст, сохранение оставляет значение перевода, а игнорирование исключает содержимое из результата в форматах, которые это поддерживают.
Загрузите результат в среду, где он будет использоваться. В документах проверьте изменённый отрывок, ссылки и компоненты. Разрешите конфликты pull, прежде чем заменять локальные правки. Затем сохраните принятые переводы в коммите вместе с соответствующей версией исходного текста и Lockfile.