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

Integration with GitLab makes source and translation files synchronized with GitLab repository and Crowdin translation project. Все переведенные и утвержденные файлы будут автоматически отправлены в виде запроса слияния в ветку l10n репозитория GitLab.

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

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

To integrate via your GitLab Account you can click Set Up Integration and then authorize the connection with Crowdin on the GitLab side:

Для интеграции через ** учетную запись GitLab Enterprise ** вам нужно создать токен доступа. Make sure to select the required scopes:

  • Access your API
  • Read user information

Then insert your access token and Base URL into corresponding fields. Click Set Up Integration to proceed.

After the successful integration, a pop-up dialogue would appear in your Project Settings, Integrations tab in Crowdin. В появившемся всплывающем окне продолжите процесс настройки интеграции, выбрав необходимый репозиторий и ветки, которые необходимо перевести.

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

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

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

By default, l10n_ is added to the created service branch name. In case of necessity, it can be easily changed.

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.

There are two ways to do that: configuring online or manually by creating a configuration file.

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

Эта процедура одинакова для интеграций со всеми системами контроля версий (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. Подробнее о создании файла конфигурации.

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

Having completed the process of integration setup, in the Project Settings, Integrations tab, all the information about integration will be stored there. По умолчанию синхронизация обрабатывается каждые 10 минут автоматически. В случае необходимости немедленного запуска, нажмите ** Синхронизировать сейчас **.

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

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