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

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

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

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

Выберите источник для своего рабочего процесса #

ИсточникКак измерить
Активность в CrowdinПодключите Crowdin, настройте измерение по событиям и проверьте полученное событие и ответ в Radar. Для просмотра страниц Radar нужен доступ к нему.
Коммиты GitHubПодключите GitHub App и настройте пути к исходным файлам и переводам. Изменения поддерживаемых ключей локализации в ветке по умолчанию становятся событиями.
Справочный центр ZendeskПодключите Zendesk. Изменения опубликованных статей становятся событиями исходного текста или перевода на соответствующих языках.
Локальные файлы переводовИспользуйте lingo score с настроенным компонентом оценки и выбранной моделью. Результаты сохраняются локально, вне истории событий Radar.
Переводы Lingo.devКаждая завершённая локализация — уже событие. В статье «Как проверить переводы Lingo.dev» описано, как выбрать движки, языки и выборку.

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

Собирайте данные об активности в GitHub и Zendesk #

Для GitHub установите приложение для нужного репозитория и подключите его к организации Lingo.dev. Добавьте в коммит .lingo/config.json с исходной локалью, целевыми локалями и шаблонами путей к исходным файлам. По этим путям система определяет, какие изменения относятся к исходному тексту, а какие — к переводам. Проверьте событие после того, как коммит в ветке по умолчанию изменит один из настроенных ключей локализации. Один коммит может создать события для нескольких ключей и языков.

При сборе данных из GitHub считываются файлы JSON, JSONC, YAML, YAML с корневым ключом, ресурсы Android, файлы Apple .strings, Flutter ARB, PHP и TypeScript. В статье «Изменения в репозитории» описано, как изменения становятся событиями.

Для Zendesk авторизуйте подключение к справочному центру и включите его языки. Radar записывает активность опубликованных статей отдельно для каждого языка. Откройте событие и сравните идентификатор статьи, локаль и текст с данными в Zendesk. Сам по себе сбор активности не запускает синхронизацию перевода и не публикует новую статью на целевом языке.

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

Импортируйте историю провайдера перед измерением #

Выберите, какую историю провайдера импортировать:

  • GitHub: импортирует до 5 000 последних коммитов из ветки репозитория по умолчанию. Каждый коммит считывается с версией .lingo/config.json, сохранённой на тот момент. Коммиты, созданные до появления этой конфигурации, не создают событий.
  • Zendesk: импортирует текущие опубликованные версии существующих статей, разделов и категорий на каждом языке, используя дату последнего обновления. Более ранние версии и черновики не собираются.

При подключении GitHub и Zendesk импорт истории запускается автоматически. Следите за его ходом на вкладке Настройки подключения. Чтобы запустить или повторить импорт позже:

  1. В Studio выберите репозиторий или справочный центр в разделе Подключённые, затем откройте вкладку Настройки.
  2. В разделе История коммитов для GitHub или История справочного центра для Zendesk выберите Импортировать историю.
  3. Следите за ходом импорта: счётчик показывает количество элементов провайдера, поставленных в очередь на сбор.
  4. Дождитесь, пока нужные для измерения события появятся в разделе Журналы в Radar, затем проверьте их даты, локали и текст.

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

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

Сохраните данные для сравнения #

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

Например, в ваших записях сочетание delivery.promise, локали fr и версии 42 однозначно определяет запись каталога. В версии 43 обещание может измениться.

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

Соберите данные для выбранного вопроса #

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

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

Проверьте одно собранное событие #

  1. Настройте выбранное измерение, прежде чем создавать тестовую активность в подключённом источнике.
  2. Найдите соответствующее событие. Сравните его локаль, текст, происхождение и доступный черновик со своими записями.
  3. Откройте ответ измерения и прочитайте критерий рядом с текстом. Проверьте, получен ли ответ или значение N/A либо измерение не удалось завершить.
  4. Сохраните идентификаторы события и измерения вместе с оценёнными версиями. Вносите утверждённые исправления в систему, где хранится текст.

При локальной оценке вместо этого проверьте сохранённый результат вместе с входными файлами и конфигурацией компонента оценки. Этот способ не создаёт событие в Radar.

Для повторяющегося рабочего процесса сохраняйте сведения о том, что было выбрано, собрано и измерено. В статье «Как измерять переводы из вашего пайплайна» описаны сбор данных и восстановление, включая повторные попытки и работу с изменёнными версиями.