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

Integration with GitLab synchronizes source and translation files between your GitLab repository and translation project in Crowdin. Всі перекладені і затверджені файли будуть автоматично відправлені у вигляді запиту злиття в гілку l10n сховища GitLab.

З’єднання GitLab з Crowdin

Можливі два варіанти. You can either use your GitLab Account or GitLab Enterprise Account.

Connecting GitLab Account

  1. Open Project Settings, Integrations tab in Crowdin and click Set Up Integration to integrate via your GitLab Account.

  2. Then authorize the connection with Crowdin on the GitLab side:

Connecting GitLab Enterprise Account

  1. To integrate via GitLab Enterprise Account you should create an access token. Make sure to select the required scope:

    • api – Grants complete read/write access to the API, including all groups and projects, the container registry, and the package registry
  2. Потім вставте маркер доступу та основну URL-адресу у відповідні поля. Клацніть Налаштувати інтеграцію, щоб продовжити.

  3. У спливаючому діалоговому вікні оберіть своє сховище і гілку, які потрібно перекласти. Рекомендовано переключити Дублікати рядків на Показувати (рекомендується для версій), так що між гілками однакові рядки будуть приховані. Детальніше про Дублікати рядків.

Службові гілки

When translations are finished and your languages are ready to go live, Crowdin sends merge request with translations to your version control system. Для кожної гілки, що знаходиться під локалізацією, Crowdin створює додаткову службову гілку з перекладами. Ми не задіємо безпосередньо головну гілку, щоб ви могли спочатку перевірити переклади.

Зумовлено, до імені створеної сервісної гілки додається l10n\ _. При необхідності його можна легко змінити.

Налаштування синхронізації

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

Бувають випадки, коли необхідно тимчасово відключити переклади від надсилання до сховища. У цьому випадку натисніть Редагувати, очистіть Надіслати переклади у налаштуваннях інтеграції та натисніть Зберегти. Коли ви будете готові синхронізувати переклади із сховищем, оберіть Надіслати переклади та натисніть Зберегти.

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

Незалежно від параметрів синхронізації зміни, внесені до вихідних файлів у сховищі, все одно синхронізуються із Crowdin кожні 10 хвилин.

GitLab sync settings

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

Під час налаштування інтеграції оберіть існуючі гілки сховищ, які потрібно додати в проект Crowdin. To add future branches from GitLab to Crowdin automatically, create a pattern for the branch names in the integration’s settings.

For example, you add a pattern *feature in the GitLab integration settings. В цьому випадку майбутні гілки, які містять це слово в кінці назви, будуть додані в проект.

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

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

Ім’я файлу конфігурації за замовчуванням

crowdin.yml — це ім’я файлу за замовчуванням, яке використовується для автоматично синхронізованих гілок. Щоб змінити налаштування за замовчуванням, натисніть Редагувати, у налаштуваннях інтеграції вкажіть бажане ім’я у полі Ім’я файлу конфігурації за замовчуванням та натисніть Зберегти.

Ім'я файлу конфігурації за замовчуванням

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

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

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

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

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

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

Configuration file crowdin.yaml should be stored in the GitLab repository along with each separate branch that you want to translate, so Crowdin knows what files exactly should be sent for translations.

Він повинен мати таку ж структуру, що і для інструменту синхронізації, але облікові дані вашого проекту не повинні зберігатися в заголовку файлу з міркувань безпеки. Детальніше про створення файлу конфігурації.

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

Once the integration is set up, all the related information is stored in the same place – Project Settings, Integrations tab, GitLab section. By default, synchronization is processed every hour automatically. Якщо вам потрібно запустити синхронізацію миттєво, натисніть кнопку Синхронізувати.

GitLab Sync Now

Завантаження перекладів зі сховища

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

GitLab Upload Translations

Дивись також

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