번역 관리
    1. Phrase
    2. Phrase Strings
    3. 번역 관리

    분기 (Strings)

    컨텐츠는 영어 텍스트를 Phrase Language AI를 이용해 기계 번역한 것입니다.

    사용 가능

    • Business 및 Enterprise 요금제

    라이센스 질문은 영업팀에 문의하십시오.

    사용 가능

    • Enterprise 요금제(레거시)

    라이센스 질문은 영업팀에 문의하십시오.

    중요 사항

    2025년 12월 10일부터 새로운 분기가 모든 신규 고객에게 기본적으로 활성화됩니다.

    기존 고객은 프로젝트의 Branches 탭에서 새로운 분기로 전환을 선택하여 새로운 분기 모델에 참여할 수 있습니다.

    레거시 분기는 2026년 6월 1일부터 사용 중단됩니다.

    분기는 소프트웨어 버전 관리에 사용됩니다. 브랜치라고 하는 프로젝트 파일의 복사본은 팀이 편집되지 않은 복사본을 유지하면서 동시에 프로젝트의 병렬 버전에서 작업할 수 있게 합니다. 이것은 다른 사람의 프로젝트 파일 변경 사항을 실수로 덮어쓸 위험을 제거합니다.

    새로운 브랜치가 생성될 때 주요 프로젝트이 복사되며, 변경 사항은 해당 브랜치에만 적용됩니다. 변경이 완료되면 브랜치는 주요 프로젝트에 병합됩니다. 여러 브랜치에서 동시에 작업할 수 있으며, 병합 후 브랜치는 자동으로 삭제됩니다. 병합된 브랜치는 간소화된 이력 추적을 위해 Merged 탭에서 사용할 수 있습니다. 기존 브랜치의 태그는 새로운 브랜치로 복사됩니다.

    제한 사항

    • 번역가 및 게스트를 제외한 모든 역할은 Branches 뷰에 액세스할 수 있습니다.

    • 병합은 되돌릴 수 없으며 브랜치는 복구할 수 없습니다.

    • 작업이 특정 분기에서 생성되면 주요 프로젝트에서 보이지 않으며 그 반대도 마찬가지입니다. 분기가 주요 프로젝트에 병합되면 그 안의 모든 열린 작업이 사라집니다.

    • 보고서 보기의 보고서는 활성 분기의 상태만 반영합니다. 분기를 주요 프로젝트에 병합하면 주요 프로젝트 보고서가 업데이트됩니다.

    • 활동 보기에는 활성 분기의 활동만 포함됩니다. 분기에서의 활동은 주요 프로젝트에서 보이지 않으며 그 반대도 마찬가지입니다. 분기를 주요 프로젝트에 병합할 때 분기에서의 활동이 사라집니다.

    • GitHub 동기화는 주요 프로젝트에서만 사용할 수 있으며 분기에서는 사용할 수 없습니다.

    • 분기에서 작성된 댓글은 주요 프로젝트에서 보이지 않으며 그 반대도 마찬가지입니다.

    • 주문이 분기에서 생성되면 주요 프로젝트에서 보이지 않으며 그 반대도 마찬가지입니다. 분기가 주요 프로젝트에 병합되면 그 안의 모든 열린 주문이 사라집니다.

    • 번역가는 특정 분기로 제한될 수 없으며 특정 로케일에서 작업할 수 있는 권한이 부여됩니다. 번역가는 분기와 함께 작업하는 방법에 대한 지침을 받아야 합니다.

    분기 활성화

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

    활성화되면, 작업 중인 분기를 선택할 수 있는 분기 메뉴 Branch Menu가 프로젝트 화면에 표시됩니다. CLI에서 분기를 지정하려면 --branch 매개변수를 사용하십시오:

    --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>

    분기 생성 (레거시)

    관리자, 프로젝트 관리자 및 개발자 역할은 번역 편집기에서 API를 통해 또는 CLI에서 새로운 분기를 생성할 수 있습니다.

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

    1. 프로젝트 페이지에서 분기 탭을 선택합니다.

    2. 분기 생성을 클릭합니다.

      분기 생성 창이 열립니다.

    3. 분기의 이름을 입력하십시오.

    4. 분기 생성을 클릭합니다.

      새 분기가 목록에 추가됩니다.

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

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

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

    $ phrase push --branch <branch_name>

    분기 병합 (레거시)

    분기에 변경 사항이 적용된 후, 새로운 번역을 통합하기 위해 메인 번역에 다시 병합할 수 있습니다.

    다음 리소스에 대한 변경 사항만 병합 중에 메인 분기에 적용됩니다:

    • 로캘

    • 키

    • 번역

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

    충돌

    리소스(번역, 키 또는 로캘)가 분기가 생성된 시점과 메인 프로젝트에 다시 병합될 때까지 메인 프로젝트와 분기 모두에서 변경된 경우 충돌이 발생합니다. 예를 들어, 분기가 생성된 후 메인 프로젝트에서 번역 및 키 설정(복수형과 같은)이 변경되어 분기의 값이 메인 프로젝트의 값과 다를 수 있습니다.

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

    1. 프로젝트의 분기 보기에서 병합할 분기를 선택하고 비교 및 병합를 클릭합니다.

      병합 분기 페이지가 열립니다. 병합 중 수정될 번역에 대한 정보는 셀을 클릭하여 접근할 수 있습니다.

    2. 충돌이 있는 경우 병합 전략을 선택하십시오:

      • 충돌하는 변경 사항을 거부하고 기존 번역을 유지하려면 메인 프로젝트 사용을 선택하십시오.

      • 기존 번역을 분기의 변경 사항으로 교체하려면 사용 Branch Menu 분기 이름을 선택하십시오.

    3. 분기 병합을 클릭하십시오.

      분기가 메인 프로젝트에 병합됩니다.

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

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

    • use_branch은 분기에서 변경 사항을 적용하여 충돌을 해결하며, 지정되지 않은 경우 기본값입니다.

    • 사용_주요은 분기에서 변경 사항을 거부하여 충돌을 해결합니다. 사용_마스터도 지원됩니다.

    푸시 및 풀 (레거시)

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

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

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

    활성 git 분기 이름을 사용하여 푸시하고 풀하려면 --use-local-branch-name을 사용하십시오:

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

    API (레거시)

    프로젝트 인수를 사용하는 모든 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"}"

    새로운 분기

    사용 가능

    • Business 및 Enterprise 요금제

    라이센스 질문은 영업팀에 문의하십시오.

    중요 사항

    2025년 12월 10일부터 새로운 분기가 모든 신규 고객에게 기본적으로 활성화됩니다.

    기존 고객은 프로젝트의 Branches 탭에서 새로운 분기로 전환을 선택하여 새로운 분기 모델에 참여할 수 있습니다.

    새로운 분기 경험은 성능, 안정성 및 유연성을 개선하고 버전 관리 기능을 확장하기 위해 재설계된 아키텍처를 도입합니다. 팀이 콘텐츠의 여러 버전을 병행하여 작업하고, 장기 실행 분기를 최신 상태로 유지하며, 변경 사항을 더 효율적으로 병합할 수 있도록 합니다.

    새로운 기능은 다음과 같습니다:

    • 다단계(스택형) 분기

      분기는 주 분기뿐만 아니라 다른 모든 분기에서 생성할 수 있습니다. 최대 5개의 분기 수준이 지원됩니다.

    • 브랜치 간의 변경 사항 동기화

      오래 실행되는 브랜치는 기본 브랜치에 변경 사항이 누적됨에 따라 구식이 될 수 있습니다. 새로운 분기는 불일치를 방지하는 데 도움이 되는 동기화 기능을 도입합니다.

    생성된 지 30일 이상 병합되지 않은 브랜치는 Strings 관리되는 단어에 포함됩니다.

    브랜치 생성하기

    관리자, 프로젝트 관리자, 디자이너 및 개발자 역할은 브랜치 탭에서 API 또는 CLI를 통해 새로운 브랜치를 생성할 수 있습니다.

    UI에서 브랜치를 생성하려면 다음 단계를 따르세요:

    1. 프로젝트 페이지에서 분기 탭을 선택합니다.

    2. 분기 생성을 클릭합니다.

      분기 생성 창이 열립니다.

    3. 분기의 이름을 입력하십시오.

    4. 기존 브랜치 목록에서 기본 브랜치를 선택합니다.

    5. 생성을 클릭합니다.

      새 분기가 목록에 추가됩니다.

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

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

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

    $ phrase push --branch <branch_name>

    브랜치 동기화

    동기화는 작업 브랜치가 원래 브랜치의 최신 변경 사항과 일치하도록 유지합니다. 이렇게 하면 번역가들이 장기 프로젝트에서도 업데이트된 콘텐츠 버전으로 작업할 수 있습니다.

    브랜치를 기본 브랜치와 동기화하려면 다음 단계를 따르세요:

    1. 브랜치 탭에서 원하는 브랜치 옆의 기본 브랜치와 동기화를 클릭합니다.

      동기화 페이지가 표시되며, 기본 브랜치와 동기화할 충돌 및 변경 사항에 대한 정보가 포함됩니다.

    2. 동기화하기 전에 검토할 수 있도록 감지된 변경 사항 중 하나를 클릭합니다.

      선택한 변경 사항에 대한 세부 정보가 포함된 표가 표시됩니다.

    3. 동기화를 선택하고 변경 사항을 적용하기 위해 확인합니다.

      변경 사항이 기본 브랜치에 추가되고 번역 편집기에서 볼 수 있게 됩니다. 마지막 동기화에 대한 정보가 동기화됨 열의 브랜치 탭에 표시됩니다.

    브랜치 동기화는 이 CLI 명령을 실행하여 API를 통해 수행할 수도 있습니다:

    $ 구문 브랜치 동기화 \
  --project_id <project_id> \
  --name <branch_name> \
  --data '{"strategy":"use_main"}' \
  --access_token <token>

    • use_branch은 분기에서 변경 사항을 적용하여 충돌을 해결하며, 지정되지 않은 경우 기본값입니다.

    • 기본_브랜치는 브랜치의 변경 사항을 거부하여 충돌을 해결하고 기본 브랜치를 참조합니다. 스택된 브랜치로 작업할 때, 기본 브랜치는 반드시 실제 주요 프로젝트 브랜치일 필요는 없습니다.

    브랜치 병합

    브랜치에서 번역 또는 버전별 작업을 완료한 후, 모든 변경 사항은 기본 브랜치에 병합될 수 있습니다. 모든 변경 사항이 체인 상단으로 병합되면, 최상위 브랜치는 주요 브랜치에 병합될 수 있습니다.

    성공적인 병합 후, 병합된 브랜치는 자동으로 삭제되며, 기록 추적을 위해 병합됨 탭에 나타납니다.

    병합 중에 기본 브랜치에 적용되는 리소스의 변경 사항은 다음과 같습니다:

    • 로캘

    • 키

    • 번역

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

    활성 하위 브랜치가 있는 브랜치는 하위 브랜치가 삭제되거나 먼저 병합될 때까지 병합할 수 없습니다.

    충돌

    자원(번역, 키 또는 로캘)이 브랜치가 생성되거나 마지막으로 동기화된 후 현재 브랜치와 기본 브랜치 모두에서 변경되면 충돌이 발생합니다. 충돌은 기본 브랜치에 병합할 때만 발생하는 것이 아니라 브랜치 스택의 모든 수준에서 발생할 수 있습니다.

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

    1. 프로젝트의 브랜치 탭에서 원하는 브랜치 옆에 있는 기본 브랜치와 병합를 클릭합니다.

      병합 페이지가 열립니다. 병합 중 수정될 번역에 대한 정보는 셀을 클릭하여 접근할 수 있습니다.

    2. 충돌이 있는 경우 병합 전략을 선택하십시오:

      • 충돌하는 변경 사항을 거부하고 기존 번역을 보존하려면 기본 브랜치 사용을 선택합니다.

      • 기존 번역을 분기의 변경 사항으로 교체하려면 사용 Branch Menu 분기 이름을 선택하십시오.

    3. 병합을 클릭하고 변경 사항을 적용하려면 확인합니다.

      브랜치는 기본 브랜치에 병합되고 자동으로 삭제됩니다. 병합된 브랜치 기록을 검토하려면 브랜치 페이지의 병합됨 탭을 엽니다.

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

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

    • use_branch은 분기에서 변경 사항을 적용하여 충돌을 해결하며, 지정되지 않은 경우 기본값입니다.

    • 사용_주요은 분기에서 변경 사항을 거부하여 충돌을 해결합니다. 사용_마스터도 지원됩니다.

    병합 작업은 병합된 브랜치를 자동으로 삭제합니다.

    푸시 및 풀 (레거시)

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

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

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

    활성 git 분기 이름을 사용하여 푸시하고 풀하려면 --use-local-branch-name을 사용하십시오:

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

    API (레거시)

    프로젝트 인수를 사용하는 모든 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"}"
    도움이 되었습니까?
    ★ ★ ★ ★ ★

    Sorry about that! In what way was it not helpful?

    The article didn’t address my problem.
    I couldn’t understand the article.
    The feature doesn’t do what I need.
    Other reason.

    Note that feedback is provided anonymously so we aren't able to reply to questions.
    If you'd like to ask a question, submit a request to our Support team.
    Thank you for your feedback.

    Articles related to Administration

    Articles related to Project Manager