CLI 버전 0의 번역가용 메모
기존 JSONC 또는 Xcode 메시지 옆에 사용 위치별 의미를 적고, 해당 번역을 명시적으로 갱신하세요.
짧은 레이블에는 번역가에게 필요한 정보가 빠져 있기 쉽습니다. 메모를 활용하면 인터페이스에 표시되는 문구를 늘리지 않고도 대상, 동작, 격식 수준을 명확히 전달할 수 있습니다. 기존 워크플로에서는 지원 여부에 따라 JSONC 주석이나 Xcode 카탈로그의 내장 주석 필드를 사용하세요.
생략된 의미 설명하기 #
{
// Patient medical records, not music recordings
"records": "Records",
// Button that submits the form; use a short action label
"submit": "Submit",
// Visual theme, not weight
"theme.light": "Light"
}i18n.json에서 주석을 지원하는 파서를 선택하세요:
{
"buckets": {
"jsonc": { "include": ["locales/[locale].jsonc"] }
}
}“저장된 의료 기록 모음”은 대상을 명확히 설명하지만, “사용자에게 표시되는 텍스트”는 그렇지 않습니다. 표시 위치와 격식 수준에 관한 메모를 남기면 공식 안내문과 동작 레이블의 표현이 다른 이유를 설명할 수 있습니다. 반드시 그대로 유지해야 하는 값은 언어적 설명에 의존하지 말고 키 제어로 보호하세요.
해당 번역 결과 확인하기 #
메모만 수정하면 원문 값의 체크섬은 바뀌지 않을 수 있습니다. 설치된 버전에서 변경되지 않은 텍스트를 건너뛴다면 선택 항목 재번역을 요청하세요. 번역된 레이블은 실제 인터페이스의 주변 맥락과 함께 읽어 보세요.
XCStrings에서는 내장 주석 필드를 사용하고 공유 카탈로그의 로캘 구조를 유지하세요. 다른 버킷에서도 같은 방식으로 메모를 읽는다고 가정하기 전에 기존 형식을 확인하세요. 이러한 기존 주석은 현재 React 카탈로그의 해시 및 컨텍스트 규약에 포함되지 않습니다.
사용 위치별 메모는 로컬라이제이션 엔진 전체에 적용되는 용어집, 규칙, 문체와 별도로 관리하세요. 둘 다 백엔드로 전송될 수 있으므로 어느 쪽에도 기밀 정보나 공개할 권한이 없는 내용을 넣지 마세요.