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

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

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

Можливі два варіанти. Ви можете використовувати свій обліковий запис GitHub або обліковий запис GitHub Enterprise.

Підключіться через обліковий запис GitHub

  1. У Crowdin відкрийте Налаштування проекту, вкладку Інтеграція та натисніть Налаштувати інтеграцію, щоб інтегруватися через свій обліковий запис GitHub.

  2. Потім авторизуйте підключення до Crowdin на стороні GitHub:

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

Підключіться через обліковий запис GitHub Enterprise

  1. Щоб інтегруватися через обліковий запис GitHub Enterprise, ви повинні створити токен доступу. Обов’язково оберіть потрібні області застосування:

    • repo – Повний контроль над приватними сховищами
    • admin:repo_hook – Повний контроль над хуками сховища
  2. Потім вставте маркер доступу та основну URL-адресу у відповідні поля. Клацніть Налаштувати інтеграцію, щоб продовжити.

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

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

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

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

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

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

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

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

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

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

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

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

Наприклад, додайте шаблон *feature у налаштування інтеграції GitHub. В цьому випадку майбутні гілки, які містять це слово в кінці назви, будуть додані в проект.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Після встановлення інтеграції вся відповідна інформація зберігається в тому самому місці: Налаштування проекту, вкладка Інтеграція, розділ GitHub. By default, synchronization is processed every hour automatically. Якщо вам потрібно запустити синхронізацію миттєво, натисніть кнопку Синхронізувати.

GitHub Синхронізувати зараз

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

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

Завантажити переклади GitHub

Дивись також

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