Poznámky pro překladatele

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á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.