설정 · Lingo.dev

Lingo.dev CLI를 설치하고 프로젝트를 설정한 뒤 첫 번역을 생성해 보세요.

사전 요구 사항

Node.js 18 이상이 필요합니다. 버전을 확인하려면 node -v을 실행하세요.

1단계. 프로젝트 초기화#

프로젝트 디렉터리로 이동

bash

cd your-project-directory

init 명령 실행

bash

npx lingo.dev@latest init

Windows 사용자: npx lingo.dev이 동작하지 않으면 먼저 npm install lingo.dev@latest로 패키지를 설치한 다음, npx lingo을 대신 사용하세요.

안내에 따라 진행하세요. CLI가 프로젝트 루트에 i18n.json 구성 파일을 생성합니다.

2단계. 버킷 구성#

i18n.json에서 최소 하나의 버킷을 설정하세요. 버킷은 파일 형식과 include 패턴을 묶어, 번역할 콘텐츠가 어디에 있는지 CLI에 알려줍니다:

json

{
  "$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의 로컬라이제이션 엔진은 모든 번역 요청에 브랜드 보이스, 용어집, 규칙, 모델 구성을 자동으로 적용합니다.

계정을 생성하고 API Keys 페이지에서 API 키를 발급하세요.
API 키를 환경 변수로 설정하세요:

bash

export LINGO_API_KEY="your-api-key"

추가 설정은 필요하지 않습니다. CLI는 조직의 기본 로컬라이제이션 엔진을 사용합니다. 특정 엔진을 대상으로 하려면 engineId에 i18n.json을 추가하세요:

json

{
  "engineId": "eng_SxjMwMsfOIsvV1wh"
}

4단계. 번역 생성#

bash

npx lingo.dev@latest run

CLI는 소스 파일을 찾아 번역 가능한 콘텐츠를 추출하고, 설정한 번역 백엔드로 전송한 뒤, 결과를 다시 디스크에 기록합니다. 무엇이 번역되었는지 추적할 수 있도록 i18n.lock 파일도 생성되므로 로캘 파일과 함께 커밋하세요.

다음 단계#

i18n.json

전체 구성 레퍼런스

Supported Formats

JSON, YAML, Markdown 등 20개 이상의 파일 형식

Connect Your Engine

번역을 로컬라이제이션 엔진을 통해 처리하세요

How It Works

5단계 번역 파이프라인