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

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

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

Включить возможность внесения предложений#

Для внесения предложений требуются два элемента в .coroid/i18n.json: привязка предложений к проекту и версия движка, поддерживающая их. Мастер интернационализации добавляет оба элемента по умолчанию.

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

Пригласить контрибьюторов#

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Пользователи также изменяют строки в запросах на объединение, которые не были созданы Coroid. Мастер устанавливает Перевести строки, объединённые вне Coroid по умолчанию; в противном случае установите его в Автоматизации. Когда такой pull request объединяется с вашей основной веткой, Coroid считывает результат проверки Глобализация, уже выполненной для pull request. Если какие-то строки остались отсутствующими или устаревшими, для этого объединения создаётся одна задача на перевод. Задача переводит только те строки, которые добавил или изменил pull request (с coroid-i18n версии 1.19.0 или новее); благодаря этому объединения, переведённые одновременно, никогда не влияют на строки друг друга, и открывается окно pull request с ними. Если проверка обнаружила заблокированный текст или предложения в коде, также создаётся задача на интернационализацию этого кода. Если делать больше нечего, ничего не происходит. Строки, оставшиеся после выполнения задачи, ждут Переводить очередь задач еженощно, устанавливается в том же месте: каждую ночь он считывает вашу основную ветку и создаёт одну задачу для всего, что ещё осталось необработанным, а если ничего нет — ничего не происходит.

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

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

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

Связанное#

• Рабочая среда Локализация
• Проверка Глобализация
• Интернационализировать проект
• Расписания
• Хуки