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

Модель правильно определяет большинство строк. Однако носитель языка всё равно замечает ошибки. С помощью предложений пользователь исправляет текст на вашем сайте, вы проверяете его в 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 автоматизации, чтобы проверка запускалась перед объединением.

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

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

Связанное#

• Локализация
• Интернационализация проекта
• Расписания
• Хуки