분기 (Strings)

분기는 프로젝트 설정의 고급<1> 탭에서 메인 분기를 변경으로부터 보호하는 옵션과 함께 활성화됩니다.

활성화되면, 프로젝트 화면에 분기 메뉴 <1>가 표시되어 작업할 분기를 선택할 수 있습니다. CLI<3>에서 분기를 지정하려면 --branch<4> 매개변수를 사용하십시오:

--branch <branch_name>

분기는 프로젝트의 분기 탭에 나열되며, 생성 및 병합 정보가 표시됩니다. 분기는 분기 탭에서 삭제하거나 병합할 수 있으며, 해당 분기에 대한 작업을 생성할 수도 있습니다.

API 또는 CLI를 통해 프로젝트의 모든 분기를 나열하려면 다음을 실행하십시오:

$ phrase branches list --project_id <project_id>

# 예:
$ phrase branches list --project_id 1d8ae641902624df63ce6fbd64ff9549$ phrase branches list <project_id>

API 또는 CLI를 통해 분기를 삭제하려면 다음을 실행하십시오:

$ phrase branches delete --project_id <project_id> --name <branch_name>

# 예:
$ phrase branches delete --project_id 1d8ae641902624df63ce6fbd64ff9549 --name test-test$ phrase branch delete <project_id> <branch_name>

메인 분기 보호

메인 분기 보호<1>는 메인 프로젝트에 대한 편집을 제한하여, 모든 변경 사항을 대신 분기에서 수행하도록 요구합니다.

활성화 시:

관리자, 프로젝트 관리자, 디자이너 및 개발자 역할은 분기 탭, API 또는 CLI를 통해 새 분기를 생성할 수 있습니다. 분기는 메인 분기뿐만 아니라 다른 모든 분기에서도 생성할 수 있습니다. 최대 5단계의 분기 수준이 지원됩니다.

UI에서 분기를 생성하려면 다음 단계를 따르십시오:

API 또는 CLI를 통해 분기를 생성하려면 다음을 실행합니다:

$ phrase branches create --project_id <project_id> --data <data>

번역을 푸시할 때 분기를 생성하려면 다음을 실행합니다:

$ phrase push --branch <branch_name>

동기화를 통해 작업 분기가 해당 분기가 생성된 분기의 최신 변경 사항과 일치하도록 유지할 수 있습니다. 이렇게 하면 번역가는 장기 프로젝트에서도 업데이트된 버전의 콘텐츠로 작업할 수 있습니다.

분기를 기본 분기와 동기화하려면 다음 단계를 따르십시오:

분기 동기화는 다음 CLI 명령을 실행하여 API를 통해서도 수행할 수 있습니다:

$ phrase branches sync \\
  --project_id <project_id> \
  --name <branch_name> \
  --data '{"strategy":"use_main"}' \
  --access_token <token>

분기에서 번역 또는 버전별 작업을 완료한 후, 모든 변경 사항을 기본 분기로 병합할 수 있습니다. 모든 변경 사항이 체인 위로 병합되면 최상위 분기를 메인 분기로 병합할 수 있습니다.

병합이 성공하면 병합된 분기는 자동으로 삭제되며 기록 추적을 위해 병합됨 탭에 나타납니다.

병합하는 동안 다음 리소스에 대한 변경 사항만 기본 분기에 적용됩니다:

활동, 작업, 주문과 같은 다른 리소스에 대한 변경 사항은 적용되지 않습니다.

활성 하위 요소 분기가 있는 분기는 하위 요소 분기가 먼저 삭제되거나 병합될 때까지 병합할 수 없습니다.

충돌

리소스(번역, 키 또는 로캘)가 분기 생성 후 또는 마지막 동기화 후에 현재 분기와 해당 기본 분기 모두에서 변경된 경우 충돌이 발생합니다. 충돌은 메인으로 병합할 때뿐만 아니라 분기 스택의 모든 수준에서 발생할 수 있습니다.

분기를 병합하려면 다음 단계를 따르십시오:

API 또는 CPI를 통해 분기를 병합하려면 다음을 실행하십시오:

$ phrase branches merge \\
  --project_id <project_id> \
  --name <name> \
  --data '{"strategy":"use_main"}' \
  --access_token <token>

병합 작업은 병합된 분기도 자동으로 삭제합니다.

CLI를 사용할 때 --branch 매개변수를 사용하여 푸시하거나 풀할 분기를 지정하십시오.

$ phrase push --branch <branch_name>
$ phrase pull --branch <branch_name>

지정된 분기가 프로젝트에 존재하지 않으면 클라이언트가 이를 생성합니다.

--use-local-branch-name을(를) 사용하여 활성 git 분기의 분기 이름을 사용하여 푸시 및 풀을 수행합니다:

$ phrase push --use-local-branch-name
$ phrase pull --use-local-branch-name

프로젝트 인수를 사용하는 모든 API 엔드포인트는 --branch 매개변수도 지원하여 프로젝트의 특정 분기에서 작업을 수행합니다:

$ 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"}"