Інтеграція з 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.

Зумовлено, до імені створеної сервісної гілки додається l10n\ _. In case of necessity, it can be easily changed.

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

Під час налаштування інтеграції оберіть існуючі гілки сховищ, які потрібно додати в проект Crowdin. Для того, щоб автоматично додавати майбутні ггілки з GitLab в Crowdin, створіть шаблон для назв гілок. Якщо назва гілки відповідає певним зразком, вона буде автоматично додана в Crowdin.

Наприклад, додайте шаблон *feature в налаштуваннях інтеграції GitLab. В цьому випадку майбутні гілки, які містять це слово в кінці назви, будуть додані в проект.

Щоб додати шаблон для назв гілок, виконайте наступні дії:

  1. Click Edit in the GitLab integration section.
  2. У спливаючому діалоговому вікні натисніть Показати додаткові налаштування в лівому нижньому кутку.
  3. В поле Гілки для автоматичної синхронізації використовуйте символи, такі як ‘*’, ‘?’, ‘[set]’, ‘' і інші, щоб визначити необхідні гілки.
  4. Натисніть Зберегти.

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

Щоб забезпечити інтеграцію, ви повинні вказати, які вихідні файли повинні бути перекладені і як Crowdin повинен структурувати перекладені файли в ваше сховище. Якщо ви бачите червоний значок із знаком оклику поруч з назвою сервісної гілки, це означає, що ви не вибрали вміст для синхронізації.

Є два способи зробити це: конфігурація в мережі або вручну через створення файлу конфігурації.

Налаштування Онлайн

Ця процедура однакова для інтеграцій з усіма системами контролю версій (VCS). Ознайомтеся з Інтеграції VCS: Конфігурація в мережі, щоб дізнатися про те, як вибрати вміст для синхронізації в мережі.

Створення файлу конфігурації

Конфігураційний файл 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 хвилин автоматично. У разі необхідності негайного запуску, натисніть Синхронізувати зараз.

Дивись також

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