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

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

By default, l10n_ is added to the created service branch name. If necessary it can be easily changed.

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

Під час налаштування інтеграції оберіть існуючі гілки сховищ, які потрібно додати в проект 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. 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 GitHub 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.

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

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 зараз

Дивись також

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