Lingo.dev CLI를 설치하고 프로젝트를 설정한 뒤 첫 번역을 생성해 보세요.
사전 요구 사항
Node.js 18 이상이 필요합니다. 버전을 확인하려면 node -v을 실행하세요.
1단계. 프로젝트 초기화#
프로젝트 디렉터리로 이동
cd your-project-directoryinit 명령 실행
npx lingo.dev@latest initWindows 사용자: npx lingo.dev이 동작하지 않으면 먼저 npm install lingo.dev@latest로 패키지를 설치한 다음, npx lingo을 대신 사용하세요.
안내에 따라 진행하세요. CLI가 프로젝트 루트에 i18n.json 구성 파일을 생성합니다.
2단계. 버킷 구성#
i18n.json에서 최소 하나의 버킷을 설정하세요. 버킷은 파일 형식과 include 패턴을 묶어, 번역할 콘텐츠가 어디에 있는지 CLI에 알려줍니다:
{
"$schema": "https://lingo.dev/schema/i18n.json",
"version": "1.15",
"locale": {
"source": "en",
"targets": ["es", "fr", "de"]
},
"buckets": {
"json": {
"include": ["locales/[locale].json"]
}
}
}[locale] 플레이스홀더는 런타임에 설정한 로캘 코드로 해석됩니다. 예를 들어 소스는 locales/en.json, 스페인어는 locales/es.json로 처리됩니다.
지원되는 파일 형식과 각 버킷 구성의 전체 목록은 Supported Formats에서 확인하세요.
3단계. 번역 백엔드 연결#
CLI가 번역을 생성하려면 번역 백엔드가 필요합니다. 옵션은 두 가지입니다:
Lingo.dev의 로컬라이제이션 엔진은 모든 번역 요청에 브랜드 보이스, glossary, instructions, model configuration을 자동으로 적용합니다.
export LINGO_API_KEY="your-api-key"추가 설정은 필요하지 않습니다. CLI는 조직의 기본 로컬라이제이션 엔진을 사용합니다. 특정 엔진을 대상으로 하려면 i18n.json에 engineId을 추가하세요:
{
"engineId": "eng_SxjMwMsfOIsvV1wh"
}4단계. 번역 생성#
npx lingo.dev@latest runCLI는 소스 파일을 찾아 번역 가능한 콘텐츠를 추출하고, 설정한 번역 백엔드로 전송한 뒤, 결과를 다시 디스크에 기록합니다. 무엇이 번역되었는지 추적할 수 있도록 i18n.lock 파일도 생성되므로 로캘 파일과 함께 커밋하세요.
