Samotný řetězec je často nejednoznačný. „Records“ může znamenat zdravotní záznamy, hudební nahrávky nebo řádky v databázi. Ve zdrojových souborech JSONC se komentář nad klíčem posílá do engine jako kontext, aby přeložil správný význam:
{
// Medical context: patient medical records
"records": "Records"
}Komentář se ve výstupu nikdy neobjeví — pouze navádí překlad.
Kde poznámky fungují#
Poznámky pro překladatele se načítají ze zdrojových souborů JSONC (.jsonc). Stačí na některý z nich nasměrovat položku files[]:
{ "pattern": "content/en/app.jsonc" }JSON (.json) komentáře nepodporuje, takže v něm poznámky být nemůžou. Pokud je chcete používat, zvolte pro daný soubor JSONC.
Přecházíte ze staršího CLI? To umělo načítat poznámky i z katalogů řetězců Xcode (.xcstrings). Aktuální CLI tenhle formát nepodporuje, takže dnes kontext nejlépe přidáte přes komentáře v JSONC.
Jak psát užitečné poznámky#
Dobrá poznámka doplní kontext, který samotný řetězec neobsahuje:
{
// 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"
}| Poznámka | Proč pomáhá |
|---|---|
// Appears in the top nav | řekne engine, kde se text zobrazuje a jak stručný má být |
// "Light" is the theme, not weight | upřesní slovo s více významy |
// Formal register | nastaví očekávaný tón |
Poznámky, které jen opakují samotný řetězec (// This says Welcome), nic nepřinášejí — klidně je vynechte.
Poznámky vs. konfigurace engine#
Poznámky pro překladatele fungují po jednotlivých řetězcích přímo ve zdroji. Pravidla, která mají platit pro celý jazyk — terminologii, tón nebo hlas značky — raději nastavte v engine, aby se uplatnila všude bez poznámky u každého klíče.
