CLI를 사용한 I18n 번역
Logto 번역 CLI는 Logto의 i18n 작업에 기여하는 개발자를 위해 설계된 강력한 도구입니다. 이 CLI를 사용하면 영어로 콘텐츠를 작성한 후 지원되는 모든 언어로 쉽게 번역할 수 있습니다.
프로젝트에 기여하지 않고 사용자 정의 번역을 원하는 일반 Logto 사용자라면, 우리의 현지화 가이드를 참조하세요.
v1.20.0부터 번역 명령어는 @logto/cli에서 제거되었으며, logto 모노레포의 독립형 @logto/translation 패키지로 유지 관리됩니다. 따라서 실행 방식이 약간 다릅니다.
@logto/cli에서 마이그레이션
다음은 이전과 새로운 CLI 실행 방법의 비교입니다:
이전 방법 (v1.20.0 이전):
pnpm cli translate <command> [options]
새로운 방법:
pnpm translate <command> [options]
키 동기화
phrases 패키지의 en 폴더에서 번역 키에 몇 가지 변경을 했다고 가정해 봅시다. 이러한 변경 사항을 pt-BR 폴더에 동기화하려고 합니다. 아래 명령어를 실행하여 번역 키와 파일 구조를 동기화하세요:
pnpm translate sync-keys --target pt-BR
이 명령어는 소스 언어 폴더 (기본값은 en)에서 모든 번역 키를 읽고 대상 언어 폴더 (이 예에서는 pt-BR)로 동기화합니다.
- 대상 언어 폴더가 존재하지 않으면 자동으로 생성됩니다;
- 대상 언어 폴더가 이미 존재하면 새로운 키로 업데이트되고 불필요한 키는 제거됩니다.
각 번역 키에 대해:
- 대상에 키가 없으면 번역되지 않은 구문임을 나타내는 주석과 함께 추가됩니다 (
/** UNTRANSLATED */로 표시됨); - 기준에 키가 없으면 대상에서 제거됩니다;
- 기준과 대상 모두에 키가 존재하면 대상의 값이 사용됩니다.
phrases 패키지의 모든 언어에 대해 키를 동기화하려면 아래 명령어를 실행하세요:
pnpm translate sync-keys --target all
따라서 소스 언어 폴더의 번역 키 업데이트에 집중할 수 있으며, 다른 언어의 번역 키는 자동으로 업데이트됩니다.
이 명령어는 기본적으로 phrases 패키지에 대해 실행됩니다. --package 옵션으로 패키지 이름을 지정할 수 있습니다. 예를 들어, phrases-experience 패키지의 키를 동기화하려면 --package phrases-experience를 사용하세요.
키를 동기화한 후, ChatGPT API를 사용하여 키를 번역할 수 있습니다.
ChatGPT를 사용하여 키 번역
ChatGPT를 사용하여 키를 번역하려면 아래 명령어를 실행하세요:
pnpm translate sync
이 명령어는 phrases 및 phrases-experience 패키지의 모든 언어에서 번역되지 않은 키 (/** UNTRANSLATED */로 표시됨)를 번역합니다. 이 명령어를 실행하려면 환경 변수 OPENAI_API_KEY가 필요합니다.
관련 리소스
ChatGPT를 통한 효율적인 국제화
ChatGPT를 사용한 긴 컨텍스트 JSON 번역