Ein String allein ist oft mehrdeutig. „Records“ kann Krankenakten, Schallplatten oder Datenbankzeilen bedeuten. In JSONC-Quelldateien wird ein Kommentar über einem Schlüssel als Kontext an die Engine übergeben, damit sie die richtige Bedeutung übersetzt:
{
// Medical context: patient medical records
"records": "Records"
}Der Kommentar erscheint nie in der Ausgabe — er dient nur dazu, die Übersetzung zu steuern.
Wo Anmerkungen funktionieren#
Anmerkungen für Übersetzer werden aus JSONC-Quelldateien (.jsonc) gelesen. Verweisen Sie einen files[]-Eintrag auf eine solche Datei:
{ "pattern": "content/en/app.jsonc" }JSON (.json) unterstützt keine Kommentare und kann daher keine Anmerkungen enthalten. Wenn Sie Anmerkungen verwenden möchten, nutzen Sie für diese Datei JSONC.
Sie kommen von der älteren CLI? Dort wurden Anmerkungen auch aus Xcode String Catalogs (.xcstrings) gelesen. Dieses Format wird von der aktuellen CLI nicht unterstützt, daher sind JSONC-Kommentare heute der richtige Weg, um Kontext mitzugeben.
Nützliche Anmerkungen schreiben#
Eine gute Anmerkung ergänzt Kontext, den der String selbst nicht mitbringt:
{
// Button in the checkout flow — keep it short
"checkout.pay": "Pay now",
// "Set" here means a collection, not the verb
"library.set": "Set",
// Formal tone — shown in the legal footer
"footer.terms": "Terms of Service"
}| Anmerkung | Warum das hilft |
|---|---|
// Appears in the top nav | gibt der Engine Hinweise auf die Platzierung und die gewünschte Kürze |
// "Light" is the theme, not weight | klärt die Bedeutung eines mehrdeutigen Worts |
// Formal register | macht die gewünschte Tonalität deutlich |
Anmerkungen, die den String nur wiederholen (// This says Welcome), bringen keinen Mehrwert — lassen Sie sie weg.
Anmerkungen vs. Engine-Konfiguration#
Anmerkungen für Übersetzer gelten pro String und stehen direkt im Quelltext. Regeln, die für eine ganze Sprache gelten — Terminologie, Tonalität, Markenstimme — sollten Sie stattdessen in der Engine hinterlegen, damit sie überall greifen, ohne dass Sie jedem Schlüssel eine eigene Anmerkung hinzufügen müssen.
