Yerelleştirme mesajı biçimleri

{
  "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 $$)"
 kullanın.
Değişiklik dizelerine atıfta bulunmak için tercih edilen yöntem $USER$ gibi yer tutucular olsa da
(i18n.getMessage'ın substitutions parametresi kullanılarak belirtilen dizeler)
dizeleri doğrudan iletinin içinde kullanabilirsiniz. Örneğin, aşağıdaki mesaj örneğin,
getMessage() işlevine aktarılan ilk üç değiştirme dizesi:
"message": "Params: $1, $2, $3"

Buna rağmen, $_n_ dizeleri yerine yer tutucuları kullanmaya devam etmenizi öneririz.
kullanabilirsiniz. Yer tutucuları iyi değişken adları olarak düşünebilirsiniz. Ödevinizi yazdıktan bir hafta sonra
kodunu yazarsanız büyük olasılıkla $1 ürününün ne anlama geldiğini unutursunuz, ancak yer tutucularınızın ne anlama geldiğini bilirsiniz.
Yer tutucular ve değiştirme dizeleri hakkında daha fazla bilgi için yer tutucular bölümüne bakın.

açıklama

İsteğe bağlıdır. Çevirmene yardımcı olmak için bağlam veya ayrıntılar vermeyi amaçlayan mesajın açıklaması
mümkün olan en iyi çeviriyi
yapmanız gerekir.

Aşağıda, Örnek bölümünden alınan üç açıklama örneği verilmiştir:
"description": "Ask for the user's name"
...
"description": "Greet the user"
...
"description": "Say goodbye to the user"

yer tutucular

İsteğe bağlıdır. Mesaj içinde kullanılacak bir veya daha fazla alt dizeyi tanımlar. Merchant Center’ı kullanmanızın
bir yer tutucu kullanabilirsiniz:


Mesajınızın çevrilmemesi gereken bir bölümünün metnini tanımlamak için kullanılır. Örnekler: HTML kodu,
ticari marka adları, biçimlendirme belirteçleri.
getMessage() işlevine geçirilen bir değiştirme dizesine başvurmak için. Örnek: $1.


Her yer tutucunun bir adı, "içerik" öğesi ve isteğe bağlı bir "örnek" öğe. Yer tutucu adı
büyük/küçük harfe duyarlı değildir ve ileti adıyla aynı karakterleri içerebilir.

"İçerik" öğenin değeri,
i18n.getMessage yönteminin substitutions parametresini kullanın. "İçerik"in değeri öğe
genellikle "Example.com" gibi bir şeydir veya "$1" yazın. 
yoksa boş bir dizeyle karşılaşırsınız. Aşağıdaki tabloda $_n_ dizelerinin dizelere nasıl karşılık geldiği gösterilmektedir
substitutions parametresiyle belirtilir.

substitutions parametresi
1 TL'nin değeri
2 TL'lik değer
3 TL'lik değer
userName
userName değeri
""
""
["Cira", "Kathy"]
"Cira"
"Kathy"
""

"Örnek" öğe (isteğe bağlıdır, ancak kesinlikle önerilir), içeriğin nasıl yazıldığını göstererek
son kullanıcıya görünür. Örneğin, bir tutara ilişkin yer tutucuda şöyle bir örnek bulunmalıdır:
"$23.45"

Örnek bölümünden alınan aşağıdaki snippet'te bir "yer tutucular" öğe
"our_sitemiz" adlı iki yer tutucu içerir ve "user". "our_sitemiz" yer tutucunun "example" değeri yok
öğesi, çünkü değeri "content" (içerik) girin.
"placeholders": {
  "our_site": {
    "content": "Example.com",
  },
  "user": {
    "content": "$1",
    "example": "Cira"
  }
}