Интеграция с GitLab

Интеграция Crowdin с GitLab обеспечивает синхронизацию исходных файлов и файлов перевода с репозиторием GitLab и проектом перевода Crowdin. Все переведенные и утвержденные файлы будут автоматически отправлены в виде запроса слияния в ветку l10n репозитория GitLab.

Соединение GitLab с Crowdin

Сначала откройте вкладку Интеграции пункта Настройки проекта в Crowdin. Перейдите в раздел GitLab. У вас есть два варианта. Вы можете использовать свою учетную запись GitLab или GitLab Enterprise для интеграции.

Для интеграции через вашу учетную запись GitLab вы можете нажать ** Настроить интеграцию ** а затем авторизуйте соединение с Crowdin на стороне GitLab:

Для интеграции через ** учетную запись GitLab Enterprise ** вам нужно создать токен доступа. Убедитесь, что вы выбрали необходимые области: - Доступ к вашему API - Чтение информации о пользователе

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

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

Рекомендуется переключить настройки обработки дублированных строк в * Показывать (рекомендуется для версий) *, чтобы одинаковые строки были скрыты во всех ветках.

Служебные ветви

Когда переводы завершены и ваши языки готовы к запуску, Crowdin отправляет запрос на слияние с переводами в вашу систему контроля версий. Для каждой ветви, находящейся под локализацией, Crowdin создает дополнительную служебную ветку с переводами. We do not commit directly to the master branch so you can verify translations first.

По умолчанию к имени созданной служебной ветке добавляется * l10n \ _ *. В случае необходимости это можно легко изменить.

Выбор контента для синхронизации

Чтобы обеспечить интеграцию, вы должны указать, какие исходные файлы должны быть переведены и как Crowdin должен структурировать переведенные файлы в вашем репозитории. In case, you see a red icon with an exclamatory mark next to the service branch name, this means that you didn’t choose content for synchronization.

Есть два способа сделать это: настроить онлайн или вручную, создать файл конфигурации.

Настройка Онлайн

Эта процедура одинакова для интеграций со всеми системами контроля версий (VCS). Check VCS Integrations: Configuring Online to get to know how to select content for synchronization online.

Создание файла конфигурации

Конфигурационный файл * crowdin.yaml * должен быть помещен в репозиторий GitLab вместе с каждой отдельной веткой, которую вы хотите перевести, чтобы Crowdin знал, какие именно файлы следует отправлять для переводов.

It should have the same structure as required for Synchronization Tool, but your project’s credentials should not be stored in the file’s header for the security reasons. Подробнее о создании файла конфигурации.

Проверка состояния синхронизации

Завершив процесс интеграции, на вкладке Интеграции пункта Параметры проекта, будут сохранены все сведения об интеграции. По умолчанию синхронизация обрабатывается каждые 10 минут автоматически. В случае необходимости немедленного запуска, нажмите ** Синхронизировать сейчас **.

Полезная информация

Была ли эта статья полезной?