Как собрать переводы для измерения
Выберите поддерживаемый источник и сохраните текст, версии и контекст, необходимые для измерения.
Начать измерение можно с переводов, которые ваша команда уже создаёт. Продолжайте хранить утверждённый текст в репозитории или системе управления переводами и выберите, как передавать его на проверку.
Для измерения нужна версия, которую можно однозначно определить. Если сообщение изменится после оценки, прежний ответ всё равно будет относиться к прежней формулировке. Храните версии исходного текста и перевода вместе, чтобы команда могла вернуться к данным оценки, а не восстанавливать их по текущему содержимому.
Выберите источник для своего рабочего процесса #
| Источник | Как измерить |
|---|---|
| Активность в 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 импорт истории запускается автоматически. Следите за его ходом на вкладке Настройки подключения. Чтобы запустить или повторить импорт позже:
- В Studio выберите репозиторий или справочный центр в разделе Подключённые, затем откройте вкладку Настройки.
- В разделе История коммитов для GitHub или История справочного центра для Zendesk выберите Импортировать историю.
- Следите за ходом импорта: счётчик показывает количество элементов провайдера, поставленных в очередь на сбор.
- Дождитесь, пока нужные для измерения события появятся в разделе Журналы в Radar, затем проверьте их даты, локали и текст.
Если измерение запускается по событиям провайдера, на его вкладке Обработка истории также доступна команда Импортировать события со списком подключённых репозиториев GitHub и справочных центров Zendesk. История собирается без запуска измерений. Когда нужные события появятся, включите измерение и запустите оценку исторических данных за соответствующий период.
Если после обработки истории появятся новые импортированные события, запустите её ещё раз с включённым параметром Только ещё не измеренные события. Если импорт завершится с ошибкой, проверьте его ход и повторите попытку на той же вкладке Настройки. Проверяйте обработку истории и результаты измерения отдельно от импорта.
Сохраните данные для сравнения #
Храните вместе ИД исходной системы, ИД содержимого, целевую локаль и версию перевода. Для проверки смысла добавьте соответствующую версию исходного текста. Для измерения правок сохраните черновик, на основе которого был создан отредактированный перевод.
Например, в ваших записях сочетание delivery.promise, локали fr и версии 42 однозначно определяет запись каталога. В версии 43 обещание может измениться.
Сохраняйте сведения о том, кто или что создало перевод, если рабочий процесс их передаёт: человек, модель, провайдер машинного перевода или повторное использование текста из памяти переводов. Если происхождение неизвестно, так и укажите. Тот, кто утвердил перевод в системе провайдера, не обязательно создал его: автором мог быть другой человек или модель.
Соберите данные для выбранного вопроса #
Критерий определяет, какие данные нужно собрать. Для проверки орфографии достаточно текста перевода. Для проверки смысла нужны исходный текст и перевод в паре, а также контекст, позволяющий снять неоднозначность. Для проверки терминологии нужны соответствующий термин и условия его употребления. Для проверки плейсхолдеров нужны требования к ним, а для расчёта расстояния редактирования — фактическая пара из черновика и итогового перевода.
Если для перевода нет версии исходного текста, оставьте его среди неоценённых случаев проверки смысла. Получите исходный текст, прежде чем оценивать перевод.
Проверьте одно собранное событие #
- Настройте выбранное измерение, прежде чем создавать тестовую активность в подключённом источнике.
- Найдите соответствующее событие. Сравните его локаль, текст, происхождение и доступный черновик со своими записями.
- Откройте ответ измерения и прочитайте критерий рядом с текстом. Проверьте, получен ли ответ или значение N/A либо измерение не удалось завершить.
- Сохраните идентификаторы события и измерения вместе с оценёнными версиями. Вносите утверждённые исправления в систему, где хранится текст.
При локальной оценке вместо этого проверьте сохранённый результат вместе с входными файлами и конфигурацией компонента оценки. Этот способ не создаёт событие в Radar.
Для повторяющегося рабочего процесса сохраняйте сведения о том, что было выбрано, собрано и измерено. В статье «Как измерять переводы из вашего пайплайна» описаны сбор данных и восстановление, включая повторные попытки и работу с изменёнными версиями.