CLI 버전 0 구성

서로 다른 세대의 구성을 혼용하지 않고 레거시 버킷, 로캘 경로, 번역 백엔드를 설정하세요.

lingo.dev@0.138.10는 작업 디렉터리에서 i18n.json를 읽습니다. 버킷은 사용할 파서를 지정하고 파일을 탐색하며, 로캘 설정은 소스와 대상을 지정합니다. 이 구성 규약은 현재 .lingo/config.json의 규약과는 별개입니다.

로캘과 버킷 선언 #

json
{
  "$schema": "https://lingo.dev/schema/i18n.json",
  "version": "1.15",
  "locale": { "source": "en", "targets": ["es", "fr"] },
  "buckets": {
    "json": {
      "include": ["locales/[locale].json"],
      "lockedKeys": ["brand/name"],
      "ignoredKeys": ["internal/*"],
      "preservedKeys": ["legal/terms"]
    },
    "markdown": {
      "include": ["docs/[locale]/*.md"],
      "exclude": ["docs/[locale]/drafts/*.md"]
    }
  }
}

경로는 구성 파일을 기준으로 해석됩니다. 사용할 파서는 파일 확장자가 아닌 버킷 키로 결정됩니다. 하나의 파일에 여러 로캘을 저장하는 형식이라면 레거시 형식별 출력 표를 확인하세요.

version 필드는 스키마 세대를 기록합니다. 레거시 스키마 마이그레이션으로 현재 CLI로 이전하지 않고도 해당 파일을 업데이트할 수 있습니다. 이전 구성을 보관하고 자동으로 생성된 변경 사항을 모두 검토하세요.

의도에 맞게 경로 일치시키기 #

[locale]는 소스 또는 대상 코드로 치환됩니다. 경로별 구분자를 사용하면 밑줄이 포함된 파일 이름도 처리할 수 있습니다:

json
{
  "include": [
    "standard/[locale].json",
    { "path": "legacy/[locale].json", "delimiter": "_" }
  ]
}

en-US의 경우 두 번째 경로는 legacy/en_US.json를 사용합니다. 파일 이름의 표기 방식은 백엔드에 전달되는 정규화된 로캘 값과 별개입니다.

** 재귀 탐색은 0.135.0부터 사용할 수 있으며, 이전 릴리스에서는 경로를 명시해야 합니다. 재귀 탐색에서는 기본적으로 node_modules, .git, dist, build, .next, .turbo를 제외합니다. 그 밖의 자동 생성 디렉터리 트리도 제외 항목에 추가하세요.

키 동작 지정 #

레거시 키 제어는 슬래시로 구분된 경로 탐색과 와일드카드 일치를 사용합니다. modules/ai.translation는 modules 안에서 점이 포함된 키를 문자 그대로 선택합니다. 잠금은 소스 값을 복사하고, 무시는 출력을 생략하며, 보존은 누락된 값을 소스로 채운 뒤 사람이 관리하도록 둡니다. injectLocale는 대상 로캘 코드에 해당하는 출력 키를 선택합니다.

각 동작의 정확한 결과는 키 제어를 참고하세요. 번역 지침만으로는 구조를 보호할 수 없으며, 소스 언어로 된 자리표시자는 사용 전에 사람이 번역해야 합니다.

로컬라이제이션 엔진 또는 직접 연결할 제공업체 선택 #

Lingo.dev 인증 정보를 사용하면 engineId로 로컬라이제이션 엔진의 용어집, 규칙, 어조, 모델을 선택할 수 있습니다. 명시적으로 선택하는 방식을 권장합니다. 생략하면 고정된 구성을 지정하는 대신 백엔드 정책을 따릅니다. 현재 서비스는 식별자를 요구하거나, 해당 키로 접근할 수 있는 활성화된 로컬라이제이션 엔진 중 가장 오래된 엔진을 선택할 수 있습니다.

제공업체에 직접 연결할 때는 제공업체 식별자, 모델, 프롬프트를 사용합니다. 다음은 과거의 구성 형식이며, 명시된 모델을 지금도 사용할 수 있다는 전제로 권장하는 것은 아닙니다:

json
{
  "provider": {
    "id": "openai",
    "model": "gpt-4o-mini",
    "prompt": "Translate the provided text from {source} to {target}."
  }
}

프롬프트에서는 {source}와 {target}가 로캘 코드로 치환됩니다. lingo.dev@0.138.10의 run 요청을 다른 대상으로 보내기 위해 provider.baseUrl에 의존하지 마세요. OpenAI 연동 경로는 baseUrl를 전달하지만, 버전이 고정된 제공업체 의존성은 baseURL를 읽으므로 해당 구성 값은 무시됩니다. 이 의존성은 대신 OPENAI_BASE_URL를 지원합니다. 콘텐츠나 인증 정보를 전송하기 전에 의도한 대상으로 전송되는지 확인하세요. 올라마 연동 경로도 provider.baseUrl를 무시하고 기본값으로 제공업체를 생성합니다. 실행기에서 해당 서비스에 접근할 수 있어야 하며, 원격 실행기에서는 노트북의 로컬호스트 주소를 사용할 수 없습니다.

백엔드인증 정보
Lingo.devLINGO_API_KEY
OpenAIOPENAI_API_KEY
AnthropicANTHROPIC_API_KEY
구글GOOGLE_API_KEY
미스트랄MISTRAL_API_KEY
오픈라우터OPENROUTER_API_KEY
로컬 올라마로컬 설정에서는 제공업체의 API 키를 사용하지 않습니다.

LINGO_API_URL는 Lingo.dev 서비스의 연결 대상을 변경합니다. 호환성과 신뢰성은 여전히 확인해야 합니다. 인증 정보가 구성 파일이나 로그에 포함되지 않도록 하세요. 백엔드나 탐색 설정을 변경한 뒤에는 소규모로 첫 파일 실행을 재현하세요. 모델이나 프롬프트를 변경해도 소스 지문은 바뀌지 않으므로, 기존 텍스트를 갱신하려면 명시적으로 갱신해야 합니다.