ブランチ機能はソフトウェアのバージョン管理で使用されます。ブランチ と呼ばれるプロジェクトファイルのコピーにより、 チーム は編集されていないコピーを保持しながら、プロジェクトの並列バージョンで同時に仕事をすることができます。これにより、プロジェクトファイルに対する他者の変更が誤って上書きされるリスクを排除できます。
メインの プロジェクトは、新しいブランチが作成され、そのブランチにのみ変更が加えられたときにコピーされます。変更が完了すると、ブランチはメインプロジェクトにマージされます。複数のブランチを同時に作業し、マージ後にブランチを削除できます。
制限
-
管理者、プロジェクトマネージャ、開発者のロールのみがにアクセスできます。
-
マージを元に戻すことも、ブランチを削除することもできません。
-
特定のブランチで作成された は、メインプロジェクトでは表示されず、その逆も同様です。ブランチがメインプロジェクトにマージされると、ブランチで開いているジョブはすべて失われます。
-
のレポートには、アクティブブランチのステータスのみが反映されます。ブランチを主プロジェクトにマージすると、主プロジェクトレポートが更新されます。
-
には、アクティブブランチ内のアクティビティのみが表示されます。ブランチ内のアクティビティはメインプロジェクトでは表示されず、その逆も同様です。ブランチ内のアクティビティは、メインプロジェクトにマージすると失われます。
-
GitHub Sync はメインプロジェクトでのみ使用でき、ブランチでは使用できません。
-
ブランチで作成されたコメントはメインプロジェクトには表示されず、その逆も可能です。
-
ブランチで作成さ は、メインプロジェクトでは表示されず、その逆も同様です。ブランチがメインプロジェクトにマージされると、その中の未解決のオーダーはすべて失われます。
-
翻訳者を特定のブランチに限定することはできませんが、特定ので仕事をする権限が与えられます。翻訳者はブランチでの仕事の進め方を指示される必要があります。
ブランチ機能はのタブで有効になり、メインブランチを変更から保護するオプションがあります。
有効にすると、ブランチメニュー がプロジェクト画面に表示され、作業ブランチを選択できます。CLIでブランチを指定するには、
--ブランチパラメータを使用します。
--branch <branch_name>
ブランチは、作成とマージの情報が表示されるに表示されます。からブランチを削除またはマージし、そのブランチにジョブを作成することもできます。
APIまたはCLI経由でプロジェクトのすべてのブランチを一覧表示するには、次のコマンドを実行します。
$ phrase branches list <project_id>
API または CLI 経由でブランチを削除するには、次のコマンドを実行します。
$ phrase branch delete <project_id> <branch_name>
管理者、プロジェクトマネージャ、開発者ロールは、翻訳エディタ、API または CLI で新しいブランチを作成できます。
翻訳エディタでブランチを作成するには、次の手順に従います。
API または CPI 経由でブランチを作成するには、次のコマンドを実行します。
$ phrase branches create --project_id <project_id> --data <data>
翻訳をプッシュするときにブランチを作成するには、次のコマンドを実行します。
$ phrase push --branch <branch_name>
ブランチに変更を加えた後、メインの翻訳にマージして、新しい翻訳を組み込むオーダーが可能です。
マージ時には、次のリソースへの変更のみがメインブランチに適用されます。
-
ロケール
-
キー
-
翻訳
アクティビティ、ジョブ、オーダーなどの他のリソースへの変更は適用されません。
矛盾
ブランチが作成されてからメインプロジェクトにマージされるまでの間に、メインプロジェクト内でリソース（翻訳、キー、ロケール）が変更された場合、 衝突 が発生します。たとえば、複数形などの翻訳やキー設定）がブランチ作成後にメインプロジェクトで変更され、ブランチの値がメインプロジェクトと異なることがあります。
ブランチを結合するには、次の手順に従います。
-
プロジェクトのから、マージするブランチを選択し、比較と結合をクリックします。
ページが開きます。結合中に変更する翻訳に関する情報は、セル内をクリックしてアクセスできます。
-
衝突がある場合は、結合方法を選択します。
-
を選択して、競合する変更を拒否し、既存の翻訳を保持します。
-
ブランチ
BranchName 使用を選択し、既存の翻訳をブランチの変更で置換。
-
-
結合ブランチをクリックします。
ブランチがメインプロジェクトにマージされます。
API または CPI 経由でブランチを結合するには、次のコマンドを実行します。
$ Phraseブランチ結合\
--project_id <project_id> \
--name <name> \
--data '{"strategy":"use_master"}' \
--access_token <token>
-
use_ブランチはブランチからの変更を適用することで衝突を解決し、指定しない場合はデフォルトとなります。
-
use_masterはブランチからの変更を拒否することで衝突を解決します。
CLIを使用する場合、--ブランチパラメータでプッシュまたはプル元のブランチを指定します。
$ phrase push --branch <branch_name> $ phrase pull --branch <branch_name>
指定したブランチがプロジェクトに存在しない場合、クライアントが作成します。
--使用-ローカル-ブランチ名を使用して、アクティブGitブランチのブランチ名を使用してプッシュおよびプルします。
$ Phrase push --使用-ローカル-ブランチ名 $ Phrase pull --使用-ローカル-ブランチ名
プロジェクト引数を取るすべての API エンドポイントは、プロジェクトの特定のブランチでアクションを実行するための --ブランチパラメータもサポートしています。
$ phrase upload create <project_id> \
--branch <branch_name>
--file /path/to/my/file.json \
--file-format json \
--locale-id abcd1234cdef1234abcd1234cdef1234 \
--tags awesome-feature,needs-proofreading \
--locale-mapping "{"en":"2"}" \
--format-options "{"foo": "bar"}"