JSONC

Překládejte katalogy s komentáři, využívejte kontextová vodítka a mějte jasno v tom, které komentáře se v přeloženém výstupu zachovají.

JSONC umožňuje uchovávat zprávu i její vysvětlení na jednom místě. Modul pro práci se soubory jsonc čte komentář před řetězcem jako vodítko pro překlad a překládá vnořené řetězcové hodnoty na stejných cestách jako JSON.

Tyto komentáře spravujte ve zdrojovém katalogu. Znovu sestavený cílový soubor používá odsazení dvěma mezerami a končí novým řádkem. Značky @orphan zachovává u stejných položek jako ve zdroji a všechny ostatní komentáře odstraňuje. Pokud tedy aplikace, která katalog zpracovává, potřebuje i další metadata, je nutné zajistit jejich uchování jiným způsobem.

Umístěte kontext přímo k příslušné hodnotě #

Tento katalog vysvětluje, k jaké akci čtenáře vybízí text „Zpět“:

jsonc
{
  /* @context Button that returns to the previous checkout step */
  "back": "Back",
  "product": "Acme",
}

Komentář se vztahuje k následující řetězcové hodnotě, nikoli ke všem potomkům objektu, který ji obsahuje. Pokud mezi komentářem a řetězcem stojí číslo, logická hodnota nebo null, dosud nepoužité vodítko se zruší. Komentář umístěte bezprostředně před řetězec, který popisuje, a pevné identifikátory chraňte pomocí ovládacích prvků zvoleného rozhraní.

Při použití @context tvoří vodítko zbytek daného řádku. Bez této značky se vodítkem stává celý komentář, takže se k překladateli dostane každý neprázdný komentář před řetězcem. Pokud řetězci předchází několik komentářů, použije se poslední neprázdné vodítko, i když některý z dřívějších komentářů obsahuje @context. Značka @orphan označuje metadata katalogu; řetězec lze přesto vybrat k překladu v rámci souboru.

Překlad souborů a katalogy React #

Extrakce katalogů React vytváří ploché katalogy JSONC s metadaty u jednotlivých položek. Modul pro jejich načítání rozpoznává @context, @src a @orphan. Extrakce tato pole používá k uchovávání umístění ve zdrojovém kódu a k označování zpráv, které už nebyly nalezeny. Jde o workflow pro správu katalogů, nikoli o překlad libovolného dokumentu JSONC.

Při správě extrahovaných zpráv postupujte podle dokumentace Katalogy a typy React. Neodstraňujte metadata ze zdrojového katalogu v domnění, že je běžný výstup překladu souboru znovu vygeneruje.

Nastavte překlad souborů #

CLI odvozuje jsonc z .jsonc; GitHub App používá nastavený typ souboru. Zdrojové a cílové cesty vyberte v konfiguraci CLI nebo konfiguraci GitHub.

Zachovejte správné hodnoty #

Přírůstkové porovnávání, uzamčené, zachovávané a ignorované cesty i vkládání jazyka se řídí stejnými pravidly jako v modulu pro práci se soubory JSON. Uzamčení kopíruje zdrojová data, zachování ponechává cílová data a ignorování odstraňuje cestu. Pravidla přednosti a důsledky práce s omezeným rozsahem najdete v dokumentaci JSON. Tyto možnosti nepovažujte za zaměnitelné způsoby vyloučení.

Ve znovu sestaveném souboru zkontrolujte klíče a chráněné hodnoty. Poté cílový soubor načtěte pomocí modulu, kterým vaše aplikace čte katalogy. U katalogů React ponechte zdrojová metadata dostupná pro extrakci: přeložený cílový soubor zachovává @orphan, ale ne @context ani @src.

Překladové workflow kontroluje podporované struktury zástupných symbolů a ICU, včetně změněných nebo chybějících argumentů. Prověřte nahlášená varování či chyby a poté vykreslete přijatou šablonu s hodnotami, které dodává vaše aplikace. Kromě struktury zkontrolujte také význam a úplnost.