Інтеграція з GitLab

Інтеграція Crowdin з GitLab забезпечує синхронізацію вихідних файлів і файлів перекладу з репозиторієм GitLab і проектом перекладу Crowdin. Всі перекладені і затверджені файли будуть автоматично відправлені у вигляді запиту злиття в гілку 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.

Гілки для автоматичної синхронізації

Під час налаштування інтеграції оберіть існуючі гілки сховищ, які потрібно додати в проект Crowdin. To add future branches from GitLab to Crowdin automatically, create a pattern for the branch names. Якщо назва гілки відповідає певним зразком, вона буде автоматично додана в 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. Детальніше про створення файлу конфігурації.

Перевірка стану синхронізації

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

Дивись також

Ця стаття була корисною?