Интеграция с GitHub

Интеграция Crowdin с GitHub обеспечивает синхронизацию исходных файлов и файлов перевода с репозиторием GitHub и проектом перевода Crowdin. Все переведенные и утвержденные файлы будут автоматически отправлены в виде запроса слияния в ветку l10n репозитория GitHub.

Соединение GitHub с Crowdin

Сначала откройте вкладку Интеграции пункта Настройки проекта в Crowdin. У вас есть два варианта. Вы можете использовать учетную запись GitHub или GitHub Enterprise.

Для интеграции через вашу учетную запись GitHub вы можете нажать ** Настроить интеграцию ** а затем авторизуйте соединение с Crowdin на стороне GitHub:

In case the repository you need is private, and you have limited or no access to it, please ask the repository owner to provide you with the Access Token. Afterward, insert the token into the Token field and click Set Up Integration.

Для интеграции через GitHub Enterprise Account вы должны создать токен доступа. Убедитесь, что вы выбрали все необходимые области: - Доступ к вашим общедоступным репозиториям или полный контроль над частными репозиториями (в зависимости от типа репозитория, который вы хотите перевести) - Полный контроль над хуками репозитория (чтобы вы могли получить некоторые новые файлы или изменения в старых переведенных) - обновить все пользовательские данные

Затем вставьте свой токен доступа и базовый URL в соответствующие поля. Нажмите **Настроить интеграцию ** чтобы продолжать.

After successful integration, a pop-up dialogue would appear on your Project Settings, Integrations tab in Crowdin. В появившемся всплывающем окне продолжите процесс настройки интеграции, выбрав необходимый репозиторий и ветки, которые необходимо перевести.

Рекомендуется переключить настройки обработки дублированных строк в * Показывать (рекомендуется для версий) *, чтобы одинаковые строки были скрыты во всех ветках.

Служебные ветви

When translations are finished and your languages are ready to go live, Crowdin sends pull request with translations to your version control system. Для каждой ветви, находящейся под локализацией, 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 должен структурировать переведенные файлы в вашем репозитории. 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

Проверка состояния синхронизации

После настройки интеграции вся связанная информация сохраняется в Настройках проекта разделе Github вкладки * Интеграции *
По умолчанию синхронизация обрабатывается каждые 10 минут автоматически. В случае необходимости немедленного запуска, нажмите ** Синхронизировать сейчас **.

синхронизация с github сейчас

Полезная информация

Была ли эта статья полезной?