현지화 메시지 형식

{
  "name": {
    "message": "Message text, with optional placeholders.",
    "description": "Translator-aimed description of the message.",
    "placeholders": {
      "placeholder_name": {
        "content": "A string to be placed within the message.",
        "example": "Translator-aimed example of the placeholder string."
      },
      ...
    }
  },
  ...
}

{
  "prompt_for_name": {
    "message": "What's your name?",
    "description": "Ask for the user's name"
  },
  "hello": {
    "message": "Hello, $USER$",
    "description": "Greet the user",
    "placeholders": {
      "user": {
        "content": "$1",
        "example": "Cira"
      }
    }
  },
  "bye": {
    "message": "Goodbye, $USER$. Come back to $OUR_SITE$ soon!",
    "description": "Say goodbye to the user",
    "placeholders": {
      "our_site": {
        "content": "Example.com",
      },
      "user": {
        "content": "$1",
        "example": "Cira"
      }
    }
  }
}

"prompt_for_name": {
  ...
},
"hello": {
  ...
},
"bye": {
  ...
}

"message": "What's your name?"
...
"message": "Hello, $USER$"
...
"message": "Goodbye, $USER$. Come back to $OUR_SITE$ soon!"

"message": "Amount (in $$)"
를 사용합니다.
대체 문자열(i18n.getMessage의 substitutions 매개변수를 사용하여 지정된 문자열)을 참조하는 데 $USER$와 같은 자리표시자가 선호되는 방법이지만 메시지 내에서 직접 대체 문자열을 참조할 수도 있습니다. 예를 들어 다음 메시지는 getMessage()에 전달된 처음 세 개의 대체 문자열을 나타냅니다.
"message": "Params: $1, $2, $3"

이러한 예에도 불구하고, 메시지에는 $_n_ 문자열 대신 자리표시자를 계속 사용하는 것이 좋습니다. 자리표시자를 좋은 변수 이름으로 생각해 보세요. 코드를 작성한 지 일주일이 지나면 $1가 무엇을 참조하는지 잊어버릴 수 있지만 자리표시자가 무엇을 참조하는지는 알 수 있습니다.
자리표시자 및 대체 문자열에 관한 자세한 내용은 자리표시자 섹션을 참고하세요.

설명

선택사항. 메시지에 관한 설명으로, 번역사가 최상의 번역을 제공하는 데 도움이 되는 맥락 또는 세부정보를 제공하기 위한 것입니다.

다음은 예 섹션에서 가져온 설명의 세 가지 예입니다.
"description": "Ask for the user's name"
...
"description": "Greet the user"
...
"description": "Say goodbye to the user"

자리표시자

선택사항. 메시지 내에 사용할 하위 문자열을 하나 이상 정의합니다. 자리표시자를 사용하는 이유는 다음과 같습니다.


번역하지 않을 메시지 부분의 텍스트를 정의합니다. 예: HTML 코드, 등록상표 이름, 형식 지정자
getMessage()에 전달된 대체 문자열을 참조합니다. 예: $1


각 자리표시자에는 이름, '콘텐츠' 항목, 선택사항인 '예시' 항목이 있습니다. 자리표시자 이름은 대소문자를 구분하지 않으며 메시지 이름과 동일한 문자를 포함할 수 있습니다.

'content' 항목의 값은 대체 문자열을 참조할 수 있는 문자열이며, 대체 문자열은 i18n.getMessage 메서드의 substitutions 매개변수를 사용하여 지정됩니다. '콘텐츠' 항목의 값은 일반적으로 'Example.com' 또는 '$1'입니다. 존재하지 않는 대체 문자열을 참조하면 빈 문자열이 반환됩니다. 다음 표는 $_n_ 문자열이 substitutions 매개변수로 지정된 문자열에 어떻게 대응하는지 보여줍니다.

substitutions 매개변수
1달러 값
2달러의 가치
값 3
userName
userName의 값
""
""
["Cira", "Kathy"]
"Cira"
"Kathy"
""

'예시' 항목 (선택사항이지만 권장됨)은 콘텐츠가 최종 사용자에게 표시되는 방식을 보여줌으로써 번역자에게 도움이 됩니다. 예를 들어 달러 금액의 자리표시자에는 "$23.45"와 같은 예가 있어야 합니다.

예 섹션에서 가져온 다음 스니펫은 'our_site' 및 'user'라는 두 개의 자리표시자를 포함하는 '자리표시자' 항목을 보여줍니다. 'our_site' 자리표시자에는 '예시' 항목이 없습니다. 'content' 필드에서 값을 쉽게 확인할 수 있기 때문입니다.
"placeholders": {
  "our_site": {
    "content": "Example.com",
  },
  "user": {
    "content": "$1",
    "example": "Cira"
  }
}