타입스크립트

주변 타입스크립트 구문은 그대로 유지하면서 정적 기본 내보내기 로캘 모듈의 리터럴 값을 번역합니다.

타입스크립트 로캘 모듈을 사용하면 메시지와 이를 설명하는 타입을 가까이 배치할 수 있습니다. typescript 파일 핸들러는 정적 기본 내보내기의 리터럴 값을 번역하며, 키, 가져오기 구문, 주석, 주변 타입 구문은 유지한 채 텍스트를 원래 위치에서 바꿉니다. 모듈을 실행하지 않고 소스를 읽습니다.

핸들러에 정적 카탈로그 제공하기 #

인라인 객체나 배열을 기본 내보내기로 사용하세요:

typescript
export default {
  checkout: {
    title: "Complete your order",
    retries: 3,
  },
  steps: ["Review", "Confirm"],
} as const;

문자열 단위에는 checkout.title, steps[0], steps[1]이 포함됩니다. 숫자 값은 바뀌지 않습니다. as const, satisfies, 지원되는 표현식을 감싸는 괄호는 소스에 그대로 두어도 됩니다.

번역할 값은 리터럴로 작성하세요. 핸들러는 내보낸 식별자의 선언을 찾아 값을 확인하거나 팩터리 호출을 평가하지 않습니다. 계산된 속성 키, 스프레드, 메서드, 표현식으로 생성된 값은 건너뜁니다. 템플릿 리터럴은 보간 표현식이 없을 때만 지원됩니다. 유효한 모듈인데도 번역 작업이 하나도 생성되지 않는다면, 번역 실패의 원인을 찾기 전에 기본 내보내기의 구조부터 확인하세요.

승인된 값을 의도적으로 유지하기 #

이전 소스를 기준으로 카탈로그 경로별 변경 사항을 판별합니다. 변경되지 않았거나 그 밖의 이유로 값을 결정하지 못한 문자열에는 기존 대상의 승인된 값을 사용합니다. 잠긴 경로는 현재 소스의 리터럴을 유지하고, 보존된 경로는 기존 대상 값이 있으면 그 값을 유지합니다. 이러한 제어 기능은 추가 텍스트를 찾기 위해 코드를 실행하지 않습니다.

텍스트를 바꿀 때는 소스 리터럴의 따옴표 구분자를 사용하고, 해당 구분자에 맞게 번역 내용을 이스케이프 처리합니다. 키를 새로 고칠 때는 선택되지 않은 대상 값을 유지합니다. 이 부분 결과에 없는 소스 항목은 배열 요소까지 제거될 수 있으므로, 모듈을 불러오기 전에 결과의 키와 배열에 포함된 요소를 확인하세요.

파일 선택 설정하기 #

CLI는 .ts, .mts, .cts에 대해 typescript을 추론하지만, .js나 .tsx에 대해서는 추론하지 않습니다. CLI 설정이나 GitHub를 통해 로캘 모듈을 선택하세요.

번역된 모듈 불러오기 #

이 형식은 리액트 메시지 추출과 별개입니다. 메시지 추출은 애플리케이션의 .ts 및 .tsx 소스에서 지원되는 호출을 읽어 카탈로그를 만듭니다. 반면 이 핸들러는 이미 구조화된 로캘 모듈을 번역합니다. 전체 처리 과정은 리액트 카탈로그 및 타입을 참고하세요.

모듈을 가져온 뒤 타입을 검사하고 애플리케이션의 카탈로그 로더로 불러오세요. 선택한 키를 화면에서 사용하는 메시지와 비교한 다음, 플레이스홀더가 제대로 작동하는지 테스트하세요. 각 검사는 서로 다른 문제를 찾아냅니다. 유효하지 않은 모듈은 불러올 수 없고, 선택되지 않은 동적 값은 번역되지 않은 채로 남으며, 유효한 번역이라도 잘못된 의미를 전달할 수 있습니다.