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 $$)"

$USER$ gibi yer tutucular, yerine koyma dizelerine (i18n.getMessage işlevinin substitutions parametresi kullanılarak belirtilen dizeler) başvurmanın tercih edilen yolu olsa da doğrudan ileti içinde de yer değiştirme dizelerine başvurabilirsiniz. Örneğin, aşağıdaki mesaj getMessage() içine iletilen ilk üç değiştirme dizesini ifade eder:
"message": "Params: $1, $2, $3"

Bu örnekte gösterildiği gibi, mesajlarınızda $_n_ dizelerinin yerine yer tutucular kullanmaya devam etmenizi öneririz. Yer tutucuları iyi değişken adları olarak düşünün. Kodunuzu yazdıktan bir hafta sonra $1 değerinin neyi ifade ettiğini muhtemelen unutursunuz ancak yer tutucularınızın neyi ifade ettiğ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. Çevirmenin mümkün olan en iyi çeviriyi yapmasına yardımcı olmak için bağlam veya ayrıntı sağlamayı amaçlayan mesajın açıklaması.

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. İleti içinde kullanılacak bir veya daha fazla alt dize tanımlar. Yer tutucu kullanmanın iki nedeni vardır:


Mesajınızın çevrilmemesi gereken bir kısmının metnini tanımlamak için. Örnekler: HTML kodu, ticari markalı adlar, biçimlendirme belirteci.
getMessage() içine iletilen bir değiştirme dizesini belirtmek için kullanılır. Örnek: $1.


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

"İçerik" öğesinin değeri, i18n.getMessage yönteminin substitutions parametresi kullanılarak belirtilen değiştirme dizelerini referans alabilecek bir dizedir. "İçerik" öğesinin değeri genellikle "Example.com" veya "$1" gibi bir şeydir. Var olmayan bir değiştirme dizesine atıfta bulunursanız boş bir dize alırsınız. Aşağıdaki tabloda, $_n_ dizelerinin substitutions parametresi tarafından belirtilen dizelere nasıl karşılık geldiği gösterilmektedir.

substitutions parametresi
1 ABD doları değerinde
2 TL değerinde
3 TL değerinde
userName
userName değeri
""
""
["Cira", "Kathy"]
"Cira"
"Kathy"
""

"Örnek" öğe (isteğe bağlıdır, ancak önemle tavsiye edilir), içeriğin son kullanıcıya nasıl
göründüğünü göstererek çevirmenlere yardımcı olur. Örneğin, dolar tutarı için bir yer tutucusunda "$23.45" gibi bir örnek olmalıdır.

Örnek bölümünden alınan aşağıdaki snippet'te, "our_site" ve "user" adlı iki yer tutucu içeren bir "placeholders" öğesi gösterilmektedir. "our_site" yer tutucusunun değeri, "content" (içerik) alanından
açık olduğu için "example" öğesi içermez.
"placeholders": {
  "our_site": {
    "content": "Example.com",
  },
  "user": {
    "content": "$1",
    "example": "Cira"
  }
}