Azure Repos Integration

Інтеграція з Azure Repos синхронізує вихідні файли і файли перекладу між вашим сховищем Azure Repos і проектом перекладу в Crowdin. Всі перекладені і затверджені файли будуть автоматично відправлені в якості запиту злиття в гілку l10n сховища Azure Repos.

З’єднання Azure Repos з Crowdin

1. Відкрийте в Crowdin Налаштування проекту, вкладку Інтеграції і натисніть Налаштувати інтеграцію.

   

   Note: When setting up an integration, make sure that you have the Project Administrator level permission to the necessary repo.

2. Потім авторизуйте з’єднання з Crowdin на стороні Azure Repos:

   

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

   

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Configuration file crowdin.yaml should be stored in the Azure Repos 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, Azure Repos section. By default, synchronization is processed every hour automatically. Якщо вам потрібно запустити синхронізацію миттєво, натисніть кнопку Синхронізувати.

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

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

Дивись також

• Керування версіями