번역

노트:

v1.20.0부터, translate 명령어는 @logto/cli에서 제거되었으며, logto 모노레포에서 독립적인 @logto/translate 패키지로 유지 관리됩니다. 자세한 내용은 translate CLI를 참조하세요.

CLI를 사용하여 i18n 번역을 관리하세요. 이 명령어들은 Logto에 기여하고자 하는 개발자들을 위한 것입니다. Logto를 사용자 정의 번역과 함께 사용하고자 한다면, 이 가이드를 참조하세요.

키 동기화

phrases 패키지의 en 폴더에서 번역 키에 몇 가지 변경 사항을 적용했다고 가정해봅시다. 이러한 변경 사항을 pt-BR 폴더에 동기화하고자 합니다. 아래 명령어를 실행하여 번역 키와 파일 구조를 동기화하세요:

pnpm cli translate sync-keys --target pt-BR

이 명령어는 소스 언어 폴더 (기본값은 en)에서 모든 번역 키를 읽고, 대상 언어 폴더 (이 예에서는 pt-BR)에 동기화합니다.

• 대상 언어 폴더가 존재하지 않으면 자동으로 생성됩니다;
• 대상 언어 폴더가 이미 존재하면, 새로운 키로 업데이트되고, 불필요한 키는 제거됩니다.

각 번역 키에 대해:

• 대상에 키가 없으면, 번역되지 않은 구문임을 나타내는 주석과 함께 추가됩니다 (/** UNTRANSLATED */로 표시됨);
• 기준선에 키가 없으면, 대상에서 제거됩니다;
• 기준선과 대상 모두에 키가 존재하면, 대상의 값이 사용됩니다.

phrases 패키지의 모든 언어에 대해 키를 동기화하려면, 아래 명령어를 실행하세요:

pnpm cli translate sync-keys --target all

따라서 우리는 소스 언어 폴더에서 번역 키를 업데이트하는 데 집중할 수 있으며, 다른 언어의 번역 키는 자동으로 업데이트됩니다.

정보:

이 명령어는 기본적으로 phrases 패키지에 대해 실행됩니다. --package 옵션을 사용하여 패키지 이름을 지정할 수 있습니다. 예를 들어, phrases-experience 패키지의 키를 동기화하려면 --package phrases-experience를 사용하세요.

키를 동기화한 후, ChatGPT API를 사용하여 키를 번역할 수 있습니다.

ChatGPT를 사용하여 키 번역하기

ChatGPT를 사용하여 키를 번역하려면 아래 명령어를 실행하세요:

pnpm cli translate sync

이 명령어는 phrases 및 phrases-experience 패키지의 모든 언어에서 번역되지 않은 키 (/** UNTRANSLATED */로 표시됨)를 번역합니다. 이 명령어를 실행하려면 환경 변수 OPENAI_API_KEY가 필요합니다.