Co-op Translator에서 Localizeflow로 마이그레이션

이 가이드는 기존 Co‑op Translator 설정을 GitHub에서 Localizeflow로 이전하는 방법을 설명합니다.

Co-op Translator에서 Localizeflow로 마이그레이션해야 하는 이유는 무엇인가요?

Localizeflow는 번역 작업을 GitHub Actions가 아닌 자체 인프라에서 실행하므로:

• 더 이상 6시간 GitHub Actions 제한 없음

• 깔끔하고 신뢰할 수 있는 PR 자동화

• 관리해야 할 시크릿이나 워크플로 파일 없음

1. Co-op Translator 구성 제거

현재 리포지토리에서 GitHub Actions 버전의 Co-op Translator를 사용 중이라면:

• co-op-translator.yml 워크플로 파일을 삭제하세요.
• 리포지토리에서 관련된 시크릿도 모두 제거하세요. Localizeflow가 이 부분을 완전히 대체하므로 더 이상 필요하지 않습니다.

Localizeflow GitHub App에 로그인 및 설치

1. localizeflow.com 에 방문하세요.

2. Continue with GitHub을 선택하세요.

3. Sign in with GitHub을 선택하세요.

4. GitHub 계정으로 로그인하세요.

5. GitHub로 로그인하면 Localizeflow의 계정 선택 페이지로 리디렉션됩니다. Install in new account를 선택하여 계정을 생성하고 Localizeflow GitHub App을 설치하세요.

6. Localizeflow GitHub App을 설치할 계정(개인 계정 또는 관리하는 조직)을 선택하세요.

   Localizeflow GitHub App을 GitHub 조직에 설치하려면 조직 소유자여야 합니다. 소유자가 아니라면, 이 페이지를 소유자에게 공유하고 설치 단계를 완료해 달라고 요청하세요.

7. Localizeflow가 접근할 리포지토리를 선택한 후 Save를 선택하세요.

8. Localizeflow 홈 페이지로 리디렉션됩니다.

리포지토리를 Localizeflow에 연결

1. Localizeflow 홈 페이지에서 + Connect repositories를 선택하세요.

2. 연결할 리포지토리를 하나 이상 선택한 후 Save를 선택하세요. 검색창을 사용해 특정 리포지토리를 빠르게 찾을 수 있습니다.

3. 연결된 리포지토리는 Home 페이지와 Repositories 페이지 모두에 표시됩니다.

4. 모든 연결된 리포지토리를 보려면 Repositories 페이지로 이동하세요.

   

번역 설정 구성

1. 방금 연결한 리포지토리 중 하나를 선택하세요.

2. 리포지토리 설정을 처음 구성하는 경우, 설정 페이지로 리디렉션됩니다. 설정을 저장한 후에는 언제든지 Edit 버튼을 선택해 이 페이지로 돌아올 수 있습니다.

3. 편집 페이지에서 다음 작업을 수행하세요:

   • Framework에서는 Generic Git repository를 선택하세요. 이 옵션은 Co-op Translator와 100% 호환됩니다.
   • Source language와 Target languages를 선택하세요. Select all을 사용하면 모든 사용 가능한 언어를 빠르게 선택할 수 있습니다.
   • Target branch를 선택하세요. 이 브랜치에 Localizeflow가 번역 PR을 생성합니다. 소스 문서가 main에 있다면 Target branch를 main으로 설정하는 것을 권장합니다.
   • Translation Options는 이전 Co-op Translator 설정과 동일하게 맞추세요. 예를 들어, 워크플로에 Markdown 파일, 이미지, 노트북, 디스클레이머가 포함되어 있었다면 여기서도 동일하게 활성화하세요.
   • Save를 선택하세요.

4. 저장 후 리포지토리 상세 페이지로 리디렉션됩니다. Start & Automate를 선택하세요. Localizeflow가 콘텐츠 번역을 시작하며, 소스 파일이 변경될 때마다 자동으로 풀 리퀘스트를 생성합니다.