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

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

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

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

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

Если выбранный репозиторий является приватным и у вас к нему ограниченный или запрещенный доступ, попросите у владельца репозитория предоставить вам токен доступа. После этого необходимо вставить его в поле Токен на стороне Crowdin. Затем вставьте токен в поле *токен * и нажмите ** Настроить интеграцию**.

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

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

После успешной авторизации вы будете перенаправлены обратно на вкладку Интеграции пункта * Настройки проекта * в Crowdin где появится всплывающее окно. В появившемся всплывающем окне продолжите процесс настройки интеграции, выбрав необходимый репозиторий и ветки, которые необходимо перевести.

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

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

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

По умолчанию к имени созданной служебной ветке добавляется * l10n \ _ *. В случае необходимости это можно легко изменить.

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

Чтобы обеспечить интеграцию, вы должны указать, какие исходные файлы должны быть переведены и как Crowdin должен структурировать переведенные файлы в вашем репозитории. В случае, если вы видите красный значок с восклицательным знаком рядом с именем служебной ветви, это означает, что вы не выбрали контент для синхронизации.

Есть два способа сделать это: настроить онлайн или вручную, создать файл конфигурации.

Настройка Онлайн

Эта процедура одинакова для интеграций со всеми системами контроля версий (VCS). Посмотрите Интеграции VCS: Настройка Онлайн чтобы узнать, как выбрать контент для синхронизации онлайн.

Создание файла конфигурации

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

Он должен иметь ту же структуру, что требуется для инструмента синхронизации, но учетные данные проекта не должны храниться в заголовке файла по соображениям безопасности. Подробнее о создании файла конфигурации.

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

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

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

Чтобы настроить расписание синхронизации - нажмите ** Изменить. ** и выберите интервал обновления.

время синхронизации с github

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

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