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からロケールファイルをインポートするには、次の手順に従ってください：

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

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

Bitbucketにエクスポート

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

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

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

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

履歴

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

履歴を表示するには：

Repo Syncsページからプロジェクトを選択し、履歴をクリックします。

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