문자열만 따로 보면 의미가 모호한 경우가 많습니다. "Records"는 의료 기록일 수도, 음반일 수도, 데이터베이스의 행일 수도 있습니다. JSONC 소스 파일에서는 키 위의 주석이 엔진에 맥락으로 전달되므로, 의도한 의미로 정확하게 번역할 수 있습니다:
jsonc
{
// Medical context: patient medical records
"records": "Records"
}주석은 결과물에 표시되지 않고, 번역 방향만 잡아 줍니다.
노트가 적용되는 곳#
번역 노트는 JSONC (.jsonc) 소스 파일에서 읽어옵니다. files[] 항목이 해당 파일을 가리키도록 설정하세요:
json
{ "pattern": "content/en/app.jsonc" }JSON (.json)에는 주석을 쓸 수 없어 노트를 담을 수 없습니다. 노트가 필요하다면 해당 파일은 JSONC를 사용하세요.
기존 CLI를 쓰고 계셨나요? 예전에는 Xcode String Catalog(.xcstrings)에서도 노트를 읽을 수 있었습니다. 하지만 현재 CLI는 이 형식을 지원하지 않으므로, 지금은 JSONC 주석이 맥락을 전달하는 방법입니다.
유용한 노트 작성하기#
좋은 노트는 문자열 자체만으로는 알 수 없는 맥락을 더해 줍니다:
jsonc
{
// Button in the checkout flow — keep it short
"checkout.pay": "Pay now",
// "Set" here means a collection, not the verb
"library.set": "Set",
// Formal tone — shown in the legal footer
"footer.terms": "Terms of Service"
}| 노트 | 도움이 되는 이유 |
|---|---|
// Appears in the top nav | 문자열이 어디에 쓰이는지, 얼마나 짧아야 하는지 엔진에 알려 줍니다 |
// "Light" is the theme, not weight | 여러 의미를 가진 단어의 뜻을 분명히 해 줍니다 |
// Formal register | 어조에 대한 기대치를 설정합니다 |
문자열을 그대로 되풀이하는 노트(// This says Welcome)는 도움이 되지 않으니 생략하세요.
노트와 엔진 설정#
번역 노트는 각 문자열별로 소스에 직접 작성합니다. 반면 로캘 전반에 적용되는 규칙, 예를 들어 용어, 어조, 브랜드 보이스 같은 항목은 엔진에 설정하세요. 그러면 모든 키마다 노트를 달지 않아도 전체에 일관되게 적용됩니다.
