Bitbucket (Strings)

本コンテンツはPhrase Language AIの機械翻訳により、英語から翻訳されています。

ヒント

Phrase TMSにおけるBitbucket統合に関する情報は、Bitbucket Cloud (TMS)を参照してください。

Bitbucket Syncは、Bitbucket Cloudのみサポートされています。Bitbucket Serverでは使用できません。
Bitbucket SyncはAPIを介して使用できます。

前提条件

.phrase.yml 設定ファイルは、監視対象のブランチのルートに存在する必要があります。ファイルは、リポジトリからインポート（pull）またはエクスポート（push）するファイルを定義します。
リポジトリには読み取りおよび書き込みアクセスが必要です。
設定ファイルの定義が正しくない場合、エラーが発生する可能性があります。ファイルに少なくとも1つのpushと1つのpullターゲット、正しいファイル形式、およびupdate_translationsパラメータの設定があることを確認してください。

設定ファイルのサンプル：

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

プロジェクトのIDはプロジェクト設定にあります。

リポジトリを接続

設定ファイルが整ったら、リポジトリに接続するために、次の手順に従ってください:

統合機能ページから、リポジトリ同期までスクロールし、設定をクリックします。

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

Bitbucket同期のアクティベーションページが開きます。
ワークスペースの承認ドロップダウンリストから接続するBitbucketアカウントを選択し、アクセスを許可をクリックします。

Phrase Stringsと選択したBitbucketアカウントとの接続が確立されます。Bitbucket同期設定ウィンドウが表示されます。

備考

Bitbucket統合を介して複数のアカウントを接続することはできません。
ドロップダウンリストからプロジェクトを選択します。
ドロップダウンリストからBitbucketリポジトリを選択します。

リポジトリの所有権が正しくない場合、リポジトリはドロップダウンリストに表示されません。
インポート（プッシュ）およびエクスポート（プル）するために、ドロップダウンリストからリポジトリブランチを選択します。通常、これはマスターブランチです。
認証設定と設定ファイルが正しいことを確認するために、設定を検証をクリックします。
オプションで、選択したBitbucketブランチへのすべてのコミットでファイルをインポートするために、自動インポートを選択します。
保存をクリックします。

プロジェクトは現在、選択したBitbucketリポジトリに接続され、一覧に追加されました。
（オプション）鉛筆アイコンをクリックして統合の名前を変更します。

統合機能はリポジトリ同期ページから無効化または削除できます。

オプションとして、ユーザーはBitbucketの個人設定でPhrase Stringsの認可を取り消すことにより、Bitbucket統合を削除できます。

Bitbucketからインポート

Bitbucket Syncを有効化し、リポジトリに接続した後、ロケールファイルをインポートできます。これはプルリクエストの形で行われるため、変更をレビューし、ブランチ管理を制御できます。

Bitbucketからロケールファイルをインポートするには、次の手順に従ってください：

リポジトリ同期ページからプロジェクトを選択し、インポートをクリックします。

翻訳がプロジェクトに取り込まれます。キーと現在の翻訳が更新されます。
Bitbucketでプルリクエストを承認、マージ、またはクローズします。

Bitbucketにエクスポート

Bitbucketにロケールファイルをエクスポートするには、次の手順に従ってください：

リポジトリ同期ページからプロジェクトを選択し、エクスポートをクリックします。

エクスポートウィンドウが表示されます。
PRブランチフィールドにターゲットブランチを指定します。

リポジトリ内の最新のファイルが、希望するブランチへの新しいプルリクエストとしてエクスポートされます。
ファイルがエクスポートされると、プルリクエストはリポジトリでマージまたはクローズでき、ブランチを削除できます。

履歴

リポジトリ同期は、各Phrase Stringsプロジェクトの最新のインポートとエクスポートの履歴を保持します。

履歴を表示するには：

リポジトリの同期ページから、プロジェクトを選択し、履歴をクリックします。

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