GitHub (Strings)

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

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

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

Примечание

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

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

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

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

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

Откроется окно настройки Синхронизация GitHub.
Выбрать проект из выпадающего список.
Выбрать метод аутентификация:
- Приложение GitHub (рекомендуется)
  
  Если приложение GitHub еще не установлено, нажмите аутентификация. Аутентификация выполняется один раз и может быть повторно использована для нескольких синхронизаций хранилище.
  
  Если приложение GitHub уже установлено, нажмите Управление установкой, чтобы Завершить установку приложения для целевой организация или учетная запись. Доступ к хранилище управляется на уровне организация или учетная запись и не привязан к отдельному пользователь GitHub.
- Личный токен доступа
  
  Укажите личный токен доступа к хранилище<1> с областью действия интерфейс приложений API.
  
  При использовании личного токен доступа, доступ к хранилище зависит от пользователь GitHub, который создал токен.
- Самостоятельная точка
  
  Укажите собственный интерфейс приложений API конечная точка<1> GitHub и личный токен доступа к хранилище<2> с областью действия интерфейс приложений API.
Если целевой хранилище требует подтверждено (подписанные) коммиты, следует использовать метод аутентификация через приложение GitHub. Коммиты, отправленные с использованием личного токен доступа, не подписываются, поэтому синхронизация завершается с ошибкой: \"Хранилище требует подтверждено (подписанные) коммиты.\"
Выбрать хранилище GitHub из выпадающего список.
Выбрать ветвь хранилище из выпадающего список, чтобы импортировать (push) и экспортировать (pull) из нее. Обычно это основная ветвь.
При необходимости укажите имя ветвь для запроса на включение изменений. Если оставить поле пустой, будет создана ветвь со значением по умолчанию phrase-translations.
Нажмите Validate Configuration, чтобы убедиться, что настройки аутентификация и файл конфигурации верны.
При необходимости Выбрать параметр Import behavior, чтобы определить, когда новые или обновленные файлы автоматически импортировать в проект.
Нажмите «Сохранить».

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

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

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

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

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

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

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

Примечание

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

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

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

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

Чтобы экспортировать файлы:

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

Отобразится окно Экспорт.
Укажите целевую ветвь в поле PR branch.

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

Примечание

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

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

История

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

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

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

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