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

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

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

Спочатку відкрийте вкладку Інтеграції пункту Налаштування проекту в Crowdin. У вас є два варіанти. You can either use your GitHub Account or GitHub Enterprise Account integration.

Для інтеграції через ваш обліковий запис GitHub ви можете натиснути Налаштувати інтеграцію а потім авторизуйте з’єднання з Crowdin на стороні GitHub:

У випадку, якщо сховище, яке вам потрібно, є приватним, і ви маєте обмежений доступ або не маєте до нього доступу, запитайте власника сховища, щоб надати вам Маркер доступу. Після цього вставте маркер у поле Маркер і натисніть**Налаштувати інтеграцію **.

Для інтеграції через GitHub Enterprise Account ви повинні створити маркер доступу. Make sure to select all the required scopes:

  • Access to your public repositories or full control of private repositories(depending on the type of repository you wish to translate)
  • Full control of repository hooks(so you could get some new files or changes in the old ones translated as well)
  • Update all user data

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

After successful integration, a pop-up dialogue would appear on 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\ _. При необхідності його можна легко змінити.

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

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

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

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

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

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

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

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

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

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

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

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

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. Детальніше про створення файлу конфігурації.

Розклад синхронізації

Щоб налаштувати розклад синхронізації - натисніть Змінити. і оберіть інтервал оновлення.

час синхронізації з github

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

Once the integration is set up, all the related information is stored in the same place – Project Settings, Integrations tab, GitHub section. За замовчуванням синхронізація обробляється кожні 10 хвилин автоматично. У разі необхідності негайного запуску, натисніть ** Синхронізувати зараз **.

синхронізація з github зараз

Дивись також

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