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

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

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

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

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

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

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

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

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

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

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

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

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

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

Bitbucket sync settings

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Файл конфігурації crowdin.yaml повинен зберігатися в сховищі Bitbucket разом з кожною окремою гілкою, яку потрібно перекласти, тому Crowdin знає, які саме файли слід надсилати для перекладу.

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

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

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

Bitbucket Sync Now

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

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

Bitbucket Upload Translations

Дивись також

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