Поддерживайте актуальность переводов с помощью предложений

Модель правильно определяет большинство строк. Однако носитель языка всё равно замечает ошибки. С помощью предложений такой читатель исправляет текст на вашем сайте, вы проверяете его в Coroid, а изменение попадает в ваш репозиторий как обычный pull request.

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

Включить участие#

Для участия требуются два элемента в .coroid/i18n.json: привязка предложений проекта и версия движка, поддерживающая такие функции. На вкладке Участники выберите Предложить включить участие. Coroid создаёт задачу для добавления обоих элементов, а вы объединяете её pull request. До этого момента на вкладке будет указано, чего не хватает.

Пригласить участников#

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

• Рецензирование. Оставьте Рецензировать предложения перед применением включённым для новых участников. Если эта опция отключена, предложение одобряется сразу, но только если исходный текст совпадает с содержимым вашего синхронизированного репозитория.
• Без лицензионного места. Участник не добавляется в вашу организацию и не занимает место члена команды. Доступ предоставляется только к этому проекту и выбранным языкам.
• Приглашения истекают. Человек должен войти в систему или создать аккаунт по приглашённому адресу и принять приглашение в течение семи дней.

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

Селектор на вашем сайте#

Участники вносят предложения прямо на вашем сайте, где видят текст в контексте.

1. В разделе Настройка → Источники сайтов, добавьте адрес каждого сайта — по одному HTTPS-источнику на строку — и включите его. Новые источники остаются отключёнными до тех пор, пока владелец или администратор их не включит.
2. На вкладке Участники выберите Подготовить задачу по интеграции сайта. Эта задача добавляет пакет селектора Coroid на ваш сайт. Он загружается только тогда, когда адрес страницы содержит ?coroid-translate=1, поэтому обычные посетители ничего не скачивают.
3. Участник открывает ваш сайт с этим параметром, щёлкает по строке, и всплывающее окно Coroid показывает ключ, исходный текст и текущий перевод.

Всплывающее окно проверяет плейсхолдеры перед отправкой данных. Участники входят в Coroid прямо во всплывающем окне; ваш сайт не обрабатывает их учётные данные. Анонимные предложения не принимаются.

Рецензирование#

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

Coroid сравнивает исходный текст каждого предложения с содержимым вашей синхронизированной ветки по умолчанию. Если исходный текст изменился после того, как участник его видел, одобрение невозможно, и в строке об этом будет указано; отклоните предложение, и участник сможет внести его снова.

Применить одобренные предложения#

Есть два способа превратить одобренные предложения в pull request. Оба используют одну и ту же задачу по корректировке: она выполняет команду apply-claim движка, снова проверяет каждый исходный текст, записывает только целевые каталоги и сообщает, что было применено, что устарело и что признано недействительным.

• Прямо сейчас. На вкладке Предложения выберите Подготовить задачу по корректировке. Одна задача может обработать до 500 одобренных предложений по всему проекту.
• Каждую ночь. На вкладке Автоматизации выберите Установить еженочные корректировки. Расписание запускается в 02:00 UTC, без обращения к модели, и создаёт задачу только при наличии одобренных предложений. Приостановить или возобновить его можно через расписание в Factory.

Строки, объединённые вне Coroid#

Люди также меняют строки в запросах на объединение, которые не были созданы Coroid. Установите Перевод строк, объединённых вне Coroid на вкладке Автоматизации вкладке. Когда такой pull request объединяется с вашей веткой по умолчанию, Coroid считывает результат проверки перевода, уже выполненной для pull request. Если какие-то строки остались непереведёнными или устарели, система создаёт задачу на перевод для этого объединения. Если переводить больше нечего, ничего не происходит.

Для этого требуется Переводы настройка контроля над запросами на объединение и Рецензировать каждый PR автоматизация, благодаря которой проверка запускается перед объединением.

Аудиты и уведомления#

Функция Аудит переводов настройка контроля проверяет каждый каталог по расписанию. Чтобы получать уведомления при сбое, установите Уведомления о сбое аудита на вкладке Автоматизации вкладке. Система отправляет одно сообщение через инструменты обмена сообщениями, подключённые в вашей организации, например Slack или электронную почту. Уведомления о сбоях в задачах по проверке качества и запросах на объединение не отправляются — они уже отображаются там, где выполняется работа.

Перенос настроек в другую организацию#

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

Связанное#

• Переведите свой проект
• Расписания
• Хуки