GitHub (Strings)

Phrase TMSのGitHub統合機能については、GitHub(TMS)を参照してください。

前提条件

.phrase.yml設定ファイルは、監視対象のブランチのルートに存在する必要があります。ファイルは、リポジトリからインポートpull）またはエクスポート（push）するファイルを定義します。
リポジトリには読み取りおよび書き込みアクセスが必要です。
設定ファイルの定義が正しくない場合、エラーが発生する可能性があります。ファイルに少なくとも1つのpushとpull訳文、正しいファイル形式、およびupdate_translationsパラメータの設定があることを確認してください。
GitHubアクセストークン：
- クラシックトークン
  
  レポジトリスコープが必要（パブリックリポジトリと同期する場合はpublic_repo）
- きめ細かいトークン
  
  以下の権限が必要です。
  - 目次：読み取りと書き込み
  - pullエスト：読み取りと書き込み
GitHubでSSOが有効になっている場合は、アクセストークンも有効にする必要があります。
phrase_translations ブランチは保護できません。
リポジトリ設定で署名付きコミットが不要であることを確認してください。

継続的な改善のため、ユーザーインターフェイスはビデオで紹介されているものと完全に同じではない可能性があります。

コンフィギュレーションファイルが設定されたら、リポジトリを接続する手順は、次のとおりです。

[Integrations]ページから、GitHub Syncコネクターまでスクロールし、[Configure]をクリックします。

レポジトリ同期ページが開きます。
同期/GitHub追加をクリックします。

GitHub同期設定ウィンドウが開きます。
ドロップ一覧からプロジェクトを選択します。
オプションでセルフホストインスタンスを選択し、GitHubセルフホストAPIエンドポイントを提供します。
APIスコープを持つ個人用レポジトリアクセストークンを提供する。
ドロップダウンリストからGitHubリポジトリを選択します。
インポート (push) およびエクスポート (pull) 元のリポジトリブランチをドロップダウンリストから選択します。通常はマスターブランチです。
「設定の検証」をクリックして、アクセストークンと設定ファイルが正しいことを確認します。
オプションで自動インポートを選択。選択したGitHubブランチにコミットするごとにファイルをインポートします。
保存をクリックします。

プロジェクトが選択されたGitHubリポジトリに接続され、一覧に追加されます。

push コマンドが .phrase.yml 設定ファイル内で正しく設定されていることを確認します。pushオプションは uploads APIエンドポイントと同じです。

ファイルをインポートするには：

pull コマンドが .phrase.yml コンフィギュレーションファイル内で正しく設定されていることを確認します。pullオプション（たとえば、include＿empty＿translationsパラメータ）は locales download APIエンドポイントと同じです。

ファイルをエクスポートするには：

[レポジトリ同期]ページでプロジェクトを選択し、エクスポートをクリックします。

リポジトリ内の最新の言語ファイルが新規pullエストとしてエクスポートされます。
ファイルをエクスポートしたら、pull request をリポジトリ内でマージまたはクローズし、ブランチを削除できます。

エクスポート時に問題が発生した場合は、CLIクライアントを使用して .phrase.yml設定ファイルをローカルでテストし、エラーメッセージがないか確認してください。

必要に応じて、phraseテクニカルサポートに問い合わせ、 .phrase.yml 設定ファイルをサポートリクエストに添付してください。

レポジトリ同期では、各Phrase Stringsプロジェクトの最新インポートおよびエクスポートの履歴が保持されます。

履歴を表示するには

[Repo Syncs]ページでプロジェクトを選択し、[History ]をクリックします。

プロジェクトのインポートおよびエクスポート履歴が表示されます。履歴のエクスポートエントリには、対応する結合要求へのリンクが含まれます。