JSONC

문맥 힌트로 주석이 있는 카탈로그를 번역하고, 번역 결과에 어떤 주석이 유지되는지 확인하세요.

JSONC를 사용하면 메시지와 설명을 함께 관리할 수 있습니다. jsonc 파일 처리기는 문자열 앞의 주석을 번역 힌트로 읽고, JSON과 동일한 경로를 따라 중첩된 문자열 값을 번역합니다.

주석은 원본 카탈로그에서 관리하세요. 재구성된 대상 파일은 공백 두 칸으로 들여쓰고 줄바꿈으로 끝납니다. 원본과 같은 항목에 @orphan 표시를 유지하고 나머지 주석은 모두 제거합니다. 따라서 다른 메타데이터를 사용하는 프로그램에서는 해당 메타데이터를 별도로 보존할 방법이 필요합니다.

설명할 값 바로 옆에 문맥 배치하기 #

이 카탈로그는 “뒤로”가 사용자에게 어떤 동작을 안내하는지 설명합니다.

jsonc
{
  /* @context Button that returns to the previous checkout step */
  "back": "Back",
  "product": "Acme",
}

주석은 바로 다음 문자열 값에 적용되며, 그 문자열을 포함한 객체의 모든 하위 요소에 적용되지는 않습니다. 중간에 숫자, 불리언 또는 널 값이 있으면 대기 중인 힌트가 해제됩니다. 설명할 문자열 바로 앞에 주석을 배치하고, 선택한 인터페이스의 제어 기능으로 고정 식별자를 보호하세요.

@context 표시가 있으면 해당 줄에서 표시 뒤에 오는 내용이 힌트가 됩니다. 표시가 없으면 주석 전체가 힌트가 되므로, 문자열 앞에 있는 주석은 비어 있지 않은 한 모두 번역기에 전달됩니다. 문자열 앞에 주석이 여러 개 있으면 앞선 주석에 @context 표시가 있더라도 비어 있지 않은 마지막 힌트가 사용됩니다. @orphan 표시는 카탈로그 메타데이터를 나타내며, 해당 문자열은 여전히 파일 번역 대상으로 선택할 수 있습니다.

파일 번역과 리액트 카탈로그 #

리액트 카탈로그 추출 기능은 각 항목에 메타데이터가 연결된 평면 구조의 JSONC 카탈로그를 생성합니다. 카탈로그 리더는 @context, @src, @orphan 표시를 인식합니다. 추출 과정에서는 이 필드로 원본 위치를 관리하고 더 이상 발견되지 않는 메시지를 표시합니다. 이는 카탈로그 관리 워크플로로, 임의의 JSONC 문서를 번역하는 작업과는 별개입니다.

추출된 메시지를 관리할 때는 리액트 카탈로그와 타입을 참고하세요. 일반 파일 번역 결과에서 메타데이터가 다시 생성될 것이라고 생각해 원본 카탈로그의 메타데이터를 삭제하지 마세요.

파일 번역 설정하기 #

CLI는 .jsonc에서 jsonc을 추론하고, GitHub App은 설정된 파일 유형을 사용합니다. CLI 설정 또는 GitHub 설정에서 원본 경로와 대상 경로를 선택하세요.

필요한 값 유지하기 #

증분 비교, 경로 잠금과 보존, 경로 무시, 로캘 삽입은 JSON 파일 처리기와 동일한 구분 기준을 따릅니다. 잠금은 원본 데이터를 복사하고, 보존은 대상 데이터를 유지하며, 무시는 경로를 제거합니다. 이 기능들을 서로 바꿔 쓸 수 있는 제외 방식으로 보지 말고, JSON에서 우선순위와 일부 범위에만 적용할 때의 영향을 확인하세요.

재구성된 파일의 키와 보호된 값을 확인한 다음, 애플리케이션의 카탈로그 리더로 대상 파일을 불러오세요. 리액트 카탈로그에서는 추출 과정에 원본 메타데이터를 계속 사용할 수 있도록 유지하세요. 번역된 대상 파일에는 @orphan 표시가 유지되지만 @context 및 @src 표시는 유지되지 않습니다.

번역 워크플로는 지원되는 자리표시자와 ICU 구조를 검사하며, 인수의 변경이나 누락도 확인합니다. 보고된 경고나 실패 내역을 살펴본 다음, 애플리케이션에서 제공하는 값으로 검증을 통과한 템플릿을 렌더링하세요. 구조 검사와 함께 의미가 정확한지, 빠진 내용은 없는지도 검토하세요.