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

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

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

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

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

Для интеграции через ** учетную запись GitLab Enterprise ** вам нужно создать токен доступа. Убедитесь, что вы выбрали необходимые области: - Доступ к вашему API - Чтение информации о пользователе

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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