번역 키

Lingo.dev CLI에서 번역 키가 작동하는 방식

소개

_번역 키_는 콘텐츠를 다양한 언어의 해당 번역과 연결하는 고유 식별자입니다. 특정 유형의 버킷을 구성할 때 이러한 키를 사용하여 키 잠금 또는 키 무시와 같은 버킷별 기능을 활성화할 수 있습니다.

사용자 정의 키

일부 파일 형식에서는 번역 키를 명시적으로 정의해야 합니다. 예를 들어, 다음 JSON 파일에서 title, description, version은 번역 키입니다:

{
  "title": "Hello, world!",
  "description": "A simple demo app",
  "version": "1.0.0"
}

이러한 키의 이름 지정을 완전히 제어할 수 있습니다.

자동 생성 키

일부 파일 형식에서는 파일 구조를 기반으로 번역 키가 자동 생성됩니다. 다음은 HTML 파일에 대한 자동 생성 키의 예입니다:

  • head/0/0
  • head/1#content
  • body/0/0
  • body/1/0
  • body/1/1/0

특정 콘텐츠에 대한 자동 생성 키를 식별하려면 프로젝트의 i18n.lock 파일을 확인하세요.

키 이름 변경

코드를 리팩토링하고 더 나은 구성을 위해 키 이름을 변경할 때, Lingo.dev CLI는 콘텐츠가 동일하다는 것을 자동으로 감지하고 기존 번역을 보존합니다. 이는 키 식별자만 변경되고 실제 콘텐츠는 변경되지 않을 때 불필요한 재번역 작업을 방지합니다.

자세한 내용은 키 이름 변경을 참조하세요.

키 잠금

기술적 식별자, 컴포넌트 이름 또는 브랜드 용어와 같은 일부 콘텐츠는 모든 언어에서 동일하게 유지되어야 합니다. 키 잠금을 사용하면 특정 키를 번역 처리에서 제외하고 대신 소스 값을 모든 대상 파일에 직접 복사할 수 있습니다.

자세한 내용은 키 잠금을 참조하세요.

키 무시

개발, 테스트 또는 내부 콘텐츠는 종종 번역이 필요하지 않으며 프로덕션 파일에 표시되지 않아야 합니다. 키 무시는 이러한 키를 번역 처리에서 완전히 제외하여 대상 파일에서 완전히 제외합니다.

자세한 내용은 키 무시를 참조하세요.