통합

GitHub (Strings)

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

Phrase TMS 통합에 대한 자세한 내용은 GitHub (TMS)을 참조하십시오.

기본 조건

  • 모니터링할 분기의 루트에 .phrase.yml 설정 파일이 있어야 합니다. 이 파일은 리포지토리로부터 가져오기(pull) 또는 내보내기(push)할 파일을 정의합니다.

  • 리포지토리에 대한 읽기 및 쓰기 액세스 권한이 필요합니다.

  • 잘못 정의된 구성 파일은 오류를 일으킬 수 있습니다. 파일에 하나 이상의 push 및 pull 대상이 있는지, 파일 형식이 올바른지, update_translations 매개 변수의 설정이 올바른지 확인하십시오.

  • GitHub 액세스 토큰:

    • 기존 토큰

      리포지토리 범위(공용 리포지토리와 동기화하는 경우 public_repo)가 필요합니다.

    • 세분한 토큰

      다음 권한이 필요합니다.

      • 목차: 읽기 및 쓰기

      • pull 요청: 읽기 및 쓰기

  • GitHub에서 SSO가 활성화된 경우 액세스 토큰에 대해서도 활성화해야 합니다.

  • phrase_translations 분기가 보호되지 않습니다.

  • 리포지토리 설정에 서명된 커밋이 필요하지 않은지 확인하십시오.

참고

지속적인 개선으로 사용자 인터페이스가 동영상에 표시된 것과 완전히 같지 않을 수 있습니다.

리포지토리 연결

구성 파일이 저장되면 리포지토리를 연결하려면 다음 단계를 수행하십시오.

  1. 통합 페이지에서 GitHub 동기화 커넥터로 스크롤하여 설정을 클릭합니다.

    리포지토리 동기화 페이지가 열립니다.

  2. 추가 동기화/GitHub을 클릭합니다.

    GitHub 동기화 설정 창이 열립니다.

  3. 드롭다운 목록 프로젝트 선택.

  4. 선택적으로 자기 호스팅 인스턴스를 선택하고 GitHub 자체 호스팅 API 엔드포인트를 제공하십시오.

  5. API 범위가 포함된 개인 리포지토리 액세스 토큰을 제공합니다.

  6. 드롭다운 목록에서 GitHub 리포지토리를 선택합니다.

  7. 가져오기(푸시) 및 내보내기(풀)할 리포지토리 분기을 드롭다운 목록에서 선택합니다. 이는 일반적으로 마스터 분기.

  8. 액세스 토큰과 구성 파일이 올바른지 확인하려면 설정 확인을 클릭하십시오.

  9. 선택한 GitHub 분기에 대한 모든 커밋이 포함된 파일을 가져오기 위해 자동 가져오기를 선택합니다.

  10. 저장을 클릭합니다.

    이제 프로젝트 선택한 GitHub 리포지토리 연결되어 목록 추가됩니다.

파일 가져오기

.phrase.yml 구성 파일 내에서 push 명령이 올바르게 구성되어 있는지 확인하십시오. Push 옵션은 uploads API 엔드포인트와 동일합니다.

파일을 가져오기 경우:

  • 리포지토리 동기화 페이지에서 프로젝트를 선택하고 가져오기 import_sync.png를 클릭합니다.

    언어 파일(설정 파일의 push 소스 항목으로 정의)이 프로젝트 가져옵니다.

    기본 로캘이 있어야 합니다.

    참고

    가져오기 중 문제가 발생할 경우 CLI 클라이언트를 사용하여 .phrase.yml 구성 파일을 현지 테스트하고 오류 메시지를 확인하십시오.

    필요한 경우 Phrase 기술 지원팀에 문의하고 .phrase.yml 구성 파일을 지원 요청에 첨부하십시오.

파일 내보내기

pull 명령이 .phrase.yml 구성 파일 내에서 올바르게 구성되어 있는지 확인하십시오. Pull 옵션(예: include_empty_translations 매개 변수)은 로컬 다운로드 API 엔드포인트와 동일합니다.

파일 내보내기:

  1. 리포지토리 동기화 페이지에서 프로젝트를 선택하고 내보내기 export_sync.png를 클릭합니다.

    리포지토리 최신 언어 파일은 새 pull 요청으로 내보내집니다.

  2. 파일을 내보내면 pull 요청을 리포지토리 병합하거나 닫고 분기 삭제할 수 있습니다.

참고

내보내기 중 문제가 발생할 경우 CLI 클라이언트를 사용하여 .phrase.yml 구성 파일을 현지 테스트하고 Error messages를 확인합니다.

필요한 경우 Phrase 기술 지원팀에 문의하고 .phrase.yml 구성 파일을 지원 요청에 첨부하십시오.

기록

리포지토리 동기화는 각 Phrase Strings 프로젝트 최신 가져오기 및 내보내기 기록을 유지합니다.

기록을 보려면 다음과 같이 하십시오.

  • 리포지토리 동기화 페이지에서 프로젝트를 선택하고 고문 history_sync.png 클릭합니다.

    프로젝트 가져오기 및 내보내기 기록이 표시됩니다. 내보내기 기록에 해당 병합 요청에 대한 링크가 포함됩니다.

도움이 되었습니까?

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.