Formate für Lokalisierungsnachrichten

{
  "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 $$)"
.
Platzhalter wie $USER$ sind die bevorzugte Methode, um auf Substitutionsstrings (Strings, die mit dem Parameter substitutions von i18n.getMessage angegeben werden) zu verweisen. Sie können aber auch direkt in der Nachricht auf Substitutionsstrings verweisen. Die folgende Meldung bezieht sich beispielsweise auf
die ersten drei Substitutionsstrings, die an getMessage() übergeben werden:

messages.json:
"message": "Params: $1, $2, $3"

Trotz dieses Beispiels empfehlen wir, anstelle von $_n_-Strings Platzhalter zu verwenden.
in Ihren Nachrichten. Platzhalter sind gute Variablennamen. Eine Woche, nachdem Sie den Code geschrieben haben, werden Sie wahrscheinlich vergessen, worauf sich $1 bezieht, aber Sie werden wissen, worauf sich Ihre Platzhalter beziehen.
Weitere Informationen zu Platzhaltern und Ersatzstrings finden Sie im Abschnitt Platzhalter.

Beschreibung

Optional. Eine Beschreibung der Nachricht, die Kontext oder Details liefern soll, damit die Übersetzer die bestmögliche Übersetzung vornehmen können.

Hier sind drei Beispiele für Beschreibungen aus dem Abschnitt Beispiel:

messages.json:
"description": "Ask for the user's name"
...
"description": "Greet the user"
...
"description": "Say goodbye to the user"

Platzhalter

Optional. Hiermit werden ein oder mehrere Teilstrings definiert, die in der Nachricht verwendet werden sollen. Hier sind zwei Gründe,
einen Platzhalter verwenden:


Hier können Sie den Text für einen Teil Ihrer Nachricht definieren, der nicht übersetzt werden soll. Beispiele: HTML-Code, markenrechtlich geschützte Namen, Formatierungsspezifikationen.
Damit wird auf einen Substitutionsstring verwiesen, der an getMessage() übergeben wird. Beispiel: $1.


Jeder Platzhalter hat einen Namen, einen „Inhalt“ und ein optionales "Beispiel" ein. Bei einem Platzhalternamen wird nicht zwischen Groß- und Kleinschreibung unterschieden. Er kann dieselben Zeichen wie ein Nachrichtenname enthalten.

Der Wert des Elements „content“ ist ein String, der sich auf Substitutionsstrings beziehen kann, die mit dem Parameter substitutions der Methode i18n.getMessage angegeben werden. Der Wert von „content“ Element ist
normalerweise etwa „beispiel.de“ oder "$1". Wenn Sie sich auf einen nicht vorhandenen Ersatzstring beziehen, wird ein leerer String zurückgegeben. In der folgenden Tabelle wird gezeigt, wie $_n_-Strings mit Strings übereinstimmen, die durch den Parameter substitutions angegeben werden.

Parameter substitutions
Wert von 1 €
Wert von 2 €
Wert: 3 €
userName
Wert von userName
""
""
["Cira", "Kathy"]
"Cira"
"Kathy"
""

Das „Beispiel“ (optional, aber dringend empfohlen) hilft den Übersetzern, den Inhalt
der Endanwendenden angezeigt wird. Ein Platzhalter für einen Dollarbetrag sollte beispielsweise "$23.45" enthalten.

Das folgende Snippet aus dem Abschnitt Beispiel enthält einen Platzhalter Element, das
enthält zwei Platzhalter mit dem Namen „our_site“. und „user“. „our_site“ Platzhalter hat kein „Beispiel“
-Element, da sein Wert an der Spalte "content" deutlich ist. ein.

messages.json:
"placeholders": {
  "our_site": {
    "content": "Example.com",
  },
  "user": {
    "content": "$1",
    "example": "Cira"
  }
}