Lingo.dev + .yaml (데이터)

Lingo.dev CLI는 구성 및 콘텐츠 관리를 위해 구조, 데이터 타입 및 형식을 보존하면서 YAML 파일을 번역합니다. CLI는 정확한 YAML 계층 구조와 들여쓰기를 유지하고, 숫자와 불리언을 보존하면서 문자열 값만 처리하며, 개발자 문서화 주석을 그대로 유지하고, YAML 앵커와 별칭이 올바르게 작동하도록 보장하며, YAML 1.2 사양을 정확히 따릅니다.

빠른 설정

로케일 기반 이름 지정이 있는 YAML 파일에 대한 구성:

{
  "locale": {
    "source": "en",
    "targets": ["es", "fr", "de"]
  },
  "buckets": {
    "yaml": {
      "include": ["config/[locale].yaml"]
    }
  }
}

주의사항: [locale]은 CLI 실행 중에 실제 로케일로 대체되므로 구성에 문자 그대로 남겨두어야 하는 플레이스홀더입니다.

YAML 콘텐츠 번역

npx lingo.dev@latest i18n

문자열 값을 번역하는 동안 YAML 구조, 데이터 타입, 주석 및 형식을 보존합니다.

구조 보존

중첩된 구성

app:
  name: "내 애플리케이션"
  description: "생산성을 위한 강력한 도구"
  features:
    - "실시간 협업"
    - "고급 검색"
    - "커스텀 테마"

database:
  host: "localhost"
  port: 5432

기술적 구성은 변경되지 않고 문자열 값만 번역됩니다.

혼합 데이터 타입

user_interface:
  welcome_message: "플랫폼에 오신 것을 환영합니다!"
  max_items: 100
  enable_notifications: true
  created_at: 2024-01-15T10:30:00Z

번역 가능한 문자열만 처리되며, 숫자, 불리언 및 날짜는 그대로 유지됩니다.

고급 기능

주석 보존

# 애플리케이션 구성

app:
  # 사용자 대면 문자열
  title: "대시보드"
  tagline: "효율적으로 프로젝트 관리하기"

  # 기술적 설정 (번역되지 않음)
  version: "1.2.0"

주석은 소스 파일에 작성된 그대로 유지됩니다.

앵커 및 참조 지원

defaults: &defaults
  timeout: 30
  retries: 3

production:
  <<: *defaults
  message: "프로덕션 환경 준비 완료"

번역 과정에서 YAML 앵커와 참조가 보존됩니다.

고급 구성

다중 YAML 파일

"yaml": {
  "include": [
    "config/[locale].yaml",
    "content/[locale]/*.yml"
  ]
}

기술적 키 잠금

"yaml": {
  "include": ["config/[locale].yaml"],
  "lockedKeys": ["database", "api/endpoint", "version"]
}