Интеграция с 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 \ _ *. В случае необходимости это можно легко изменить.

Branches to Sync Automatically

When you set up the integration you select existing repository branches that should be added to the Crowdin project. To add future branches from GitLab to Crowdin automatically, create a pattern for the branch names. If a branch name follows a certain pattern, it will be automatically added to Crowdin.

For example, you add a pattern *feature in the GitLab integration settings. In this case, the future branches that contain this word at the end of the title will be added to the project.

To add a pattern for branch names, follow these steps:

  1. Click Edit in the GitLab integration section.
  2. In the pop-up dialogue click Show Advanced Settings in the bottom left corner.
  3. In the Branches to Sync Automatically field, use wildcard selectors such as ‘*’, ‘?’, ‘[set]’, ‘' and others to identify the necessary branches.
  4. Кликните по кнопке Сохранить.

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

Чтобы обеспечить интеграцию, вы должны указать, какие исходные файлы должны быть переведены и как 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 минут автоматически. В случае необходимости немедленного запуска, нажмите ** Синхронизировать сейчас **.

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

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