GitHub (Strings)

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

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

Файл конфигурации .phrase.yml должен присутствовать в корне контролируемой ветви. Файл определяет, какие файлы импортировать ( pull) или экспортировать (push) из хранилища.
Для хранилища необходимо получить доступ для чтения и записи.
Неверно заданные файлы конфигурации могут вызвать ошибки. Убедитесь, что файл содержит хотя бы один push и один pull перевод, правильные форматы файлов и правильную настройку параметра Update_translations.
Токен доступа GitHub:
- Классические токены
  
  Требуется область репозитория (public_repo, если синхронизация с общедоступным хранилищем)
- Мелкозернистые токены
  
  Требуются следующие разрешения:
  - Содержимое: Чтение и запись
  - Запросы на pull: Чтение и запись
Если в GitHub включен единый вход в систему (SSO), его также необходимо активировать для токена доступа.
Невозможно защитить ветвь phrase_translations.
Убедитесь, что настройки хранилища не требуют подписанных фиксаций.

Примечание

Из-за постоянных доработок пользователь интерфейс может не полностью совпадать с тем, что представлен в видеоролике.

Подключить репозитории

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

На странице интеграций прокрутите вниз коннектор GitHub Sync и нажмите Настроить.

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

Откроется окно настроек синхронизации GitHub.
Выберите проект в раскрывающемся списке.
Дополнительно выберите самостоятельный хостинг и укажите собственную конечную точку интерфейса приложений API GitHub.
Предоставьте личный токен доступа РЕПО с областью интерфейса приложений API.
Выберите хранилище GitHub в раскрывающемся списке.
Выберите ветвь хранилища в раскрывающемся списке, чтобы импортировать (push) и экспортировать ( pull) из. Обычно это главная ветвь.
Нажмите Проверить конфигурацию, чтобы убедиться в правильности токена доступа и файла конфигурации.
Дополнительно выберите Автоматически импортировать файлы с каждой фиксацией в выбранной ветви GitHub.
Нажмите Сохранить.

Теперь проект подключен к выбранному хранилищу GitHub и добавлен в список.

Импортировать файлы

Убедитесь, что команды push правильно настроены в файле конфигурации .phrase.yml. Параметры push такие же, как для конечной точки интерфейса приложений API uploads.

Импортировать файлы:

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

В проект импортируются файлы языков (определяемые как записи push оригинала в файле конфигурации).

Должен присутствовать языковой стандарт по умолчанию.

Примечание

В случае возникновения проблем при импорте используйте клиент CLI для локального тестирования файла конфигурации .phrase.yml и проверки на наличие сообщений об ошибках.

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

Экспортировать файлы

Убедитесь, что команды pull правильно настроены в файле конфигурации .phrase.yml. Параметры pull (например, include_empty_translations) такие же, как для конечной точки интерфейса приложений API locales download.

Экспортировать файлы:

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

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

Примечание

В случае возникновения проблем при экспорте используйте клиент CLI для локального тестирования файла конфигурации .phrase.yml и проверки на наличие сообщений об ошибках.

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

История

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

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

На странице Синхронизации репозитория выберите проект и нажмите History .

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