Übersetzungshinweise in CLI v0

Ergänzen Sie ältere JSONC- oder Xcode-Texte um Hinweise zur Bedeutung an der jeweiligen Stelle und aktualisieren Sie die betroffene Übersetzung gezielt.

Kurze Beschriftungen lassen oft Informationen aus, die für die Übersetzung wichtig sind. Ein Hinweis kann erläutern, worum es geht, welche Aktion gemeint ist oder welches Sprachregister passt – ohne zusätzliche Wörter in der Oberfläche. Verwenden Sie im älteren Workflow JSONC-Kommentare oder die nativen Kommentarfelder im Xcode-Katalog, sofern sie unterstützt werden.

Die fehlende Bedeutung erläutern #

jsonc
{
  // Patient medical records, not music recordings
  "records": "Records",
  // Button that submits the form; use a short action label
  "submit": "Submit",
  // Visual theme, not weight
  "theme.light": "Light"
}

Wählen Sie in i18n.json den Parser mit Kommentarunterstützung aus:

json
{
  "buckets": {
    "jsonc": { "include": ["locales/[locale].jsonc"] }
  }
}

„Sammlung gespeicherter Patientenakten“ macht deutlich, worum es geht; „Text, der einem Nutzer angezeigt wird“ dagegen nicht. Ein Hinweis zur Platzierung und zum Sprachregister kann erklären, warum sich eine formelle Mitteilung von einer Aktionsbeschriftung unterscheidet. Verwenden Sie für einen exakten Wert, der unverändert bleiben muss, eine Steuerung auf Schlüsselebene, statt sich dafür auf einen sprachlichen Hinweis zu verlassen.

Das betroffene Ergebnis ansehen #

Wenn Sie nur den Hinweis ändern, bleibt die Prüfsumme des Quellwerts möglicherweise unverändert. Fordern Sie eine gezielte Neuübersetzung an, wenn die installierte Version unveränderten Text sonst überspringen würde. Lesen Sie die übersetzte Beschriftung dort, wo sie tatsächlich in der Oberfläche erscheint.

Verwenden Sie für XCStrings das native Kommentarfeld und behalten Sie die Sprachstruktur des gemeinsam genutzten Katalogs bei. Sehen Sie unter ältere Formate nach, bevor Sie davon ausgehen, dass eine andere Dateikategorie Hinweise genauso einliest. Diese älteren Kommentare fallen nicht unter die aktuelle Hash-/Kontext-Vereinbarung des React-Katalogs.

Halten Sie Hinweise zu einzelnen Vorkommen vom Glossar, den Regeln und der Markenstimme getrennt, die für die gesamte Lokalisierungs-Engine gelten. Sowohl diese Hinweise als auch die engineweiten Vorgaben können an das Backend gesendet werden. Sie sollten daher weder Geheimnisse noch Inhalte enthalten, zu deren Offenlegung Sie nicht berechtigt sind.