Bitbucket (Strings)

Контент автоматически переведен с английского языка с помощью Phrase Language AI.

Предварительные требования

Файл конфигурации .phrase.yml должен присутствовать в корне ветви, которую необходимо отслеживать. Файл определяет, какие файлы импортировать (отправка) или экспортировать (извлечение) из хранилища.
Для хранилища необходимо получить доступ для чтения и записи.
Неверно заданные файлы конфигурации могут вызвать ошибки. Убедитесь, что файл содержит хотя бы одну цель для отправки и одну для извлечения, правильные форматы файлов и правильную настройку параметра Update_translations.

Образец файла конфигурации:

phrase:
    project_id: 1f61b9ecdb7a17a9dd174302419c50cc
    file_format: simple_json
    push:
        sources:
            - file: ./<locale_name>.json
    pull:
        targets:
            - file: ./<locale_name>.json

Идентификатор проекта можно найти в настройках проекта.

Подключить хранилища

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

На странице Интеграции прокрутите вниз до Синхронизация хранилища и нажмите Настроить.

Откроется страница Синхронизации хранилищ.
Нажмите Добавить синхронизацию/Bitbucket.

Откроется страница активации Bitbucket Sync.
Выберите учетную запись Bitbucket для подключения в раскрывающемся списке Авторизовать для рабочей области и нажмите Получить доступ.

Соединение между Phrase Strings и выбранной учетной записью Bitbucket установлено. Отобразится окно настроек Bitbucket sync.

Примечание

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

Если право собственности на хранилище указано неверно, хранилище не будет отображаться в выпадающем списке.
Выберите ветвь хранилища из выпадающего списка, чтобы импортировать (push) и экспортировать (pull) из нее. Обычно это основная ветвь.
Нажмите Validate Configuration, чтобы убедиться, что настройки аутентификации и файл конфигурации верны.
При необходимости выберите Auto import, чтобы импортировать файлы при каждом коммите в выбранную ветвь Bitbucket.
Нажмите «Сохранить».

Проект теперь подключен к выбранному хранилищу Bitbucket и добавлен в список.
(Необязательно) Нажмите значок карандаша, чтобы переименовать интеграцию.

Интеграции можно деактивировать или удалить на странице Repo Syncs.

При необходимости пользователи могут удалить интеграцию с Bitbucket, отозвав авторизацию для Phrase Strings в своих Bitbucket personal settings.

Импортировать из Bitbucket

После активации Bitbucket Sync и подключения хранилища можно импортировать файлы языковых стандартов. Это выполняется в виде запросов на включение (pull requests), поэтому изменения можно проверить, а управление ветвями — контролировать.

Чтобы импортировать файлы языковых стандартов из Bitbucket, выполните следующие действия:

На странице Repo Syncs выберите проект и нажмите импортировать .

Переводы подтягиваются в проект. Ключи и текущие переводы обновляются.
Одобрите, объедините или закройте запрос на включение в Bitbucket.

Экспорт в Bitbucket

Чтобы экспортировать файлы языкового стандарта в Bitbucket, выполните следующие действия:

На странице Синхронизация хранилищ Выберите проект и нажмите Экспорт .

Отображается окно Экспорт.
Укажите перевод ветви в поле PR branch.

Самые последние файлы в хранилище будут экспортированы как новый запрос на включение изменений в нужную ветвь.
После того как файлы будут экспортированы, запрос на включение изменений можно объединить или закрыть в хранилище, а ветвь можно удалить.

Каждый экспортированный язык приводит к отдельному коммиту в рамках запроса на включение изменений. Объединение всех экспортированных языков в один коммит в настоящее время не поддерживается для Bitbucket, в отличие от интеграции с GitHub.

История

Синхронизация хранилищ сохраняет историю последних импортов и экспортов для каждого проекта Phrase Strings.

Чтобы просмотреть историю:

На странице Синхронизация хранилищ Выберите проект и нажмите История .

Отображается история импорта и экспорта для проекта. Записи об Экспорте в истории включают ссылку на соответствующий запрос на объединение.