JSON
Překládejte vnořené řetězcové hodnoty a určujte, které cesty se zkopírují, zachovají, vynechají nebo aktualizují.
V katalogu JSON aplikace vyhledá klíč a zobrazí jeho hodnotu. Obslužná rutina pro soubory json mění řetězcové hodnoty, zatímco klíče objektů, pozice v polích, čísla, booleovské hodnoty a hodnoty null ponechává jako data. Cílový soubor znovu sestaví podle aktuálního zdroje a vloží do něj nové překlady nebo zachovaný cílový text.
Obslužná rutina podporuje katalogy s vnořenými objekty a poli i samostatný řetězec na kořenové úrovni. CLI odvodí json z .json. Zdroj nastavíte v konfiguraci CLI nebo prostřednictvím GitHub App.
Co se zařadí k překladu #
Například:
{
"checkout": {
"title": "Complete your order",
"delivery": "Delivery within {days} days"
},
"plans": [
{ "name": "Personal", "seats": 1 },
{ "name": "Team", "seats": 10 }
],
"enabled": true
}Obslužná rutina vybere checkout.title, checkout.delivery, plans[0].name a plans[1].name. Čísla seats a booleovskou hodnotu enabled ponechá beze změny. Identifikátory uložené jako řetězce je třeba výslovně chránit: datový typ hodnoty v JSON obslužné rutině říká, že jde o text, ne zda je určený lidem ke čtení.
Zkrácený zápis cesty používá tečky k procházení objektů a hranaté závorky k určení pozic v polích: checkout.title vybere vnořenou hodnotu a plans[0].name název prvního plánu. Pro klíč, jehož název je doslova checkout.title, použijte zápis JSONPath s uvozovkami $['checkout.title']. Syntaxi výběru najdete v části nastavení klíčů.
Jak aktualizace využívají stávající překlady #
Inkrementální běh pracuje se třemi samostatnými vstupy:
| Vstup | Úloha |
|---|---|
| Aktuální zdroj | Určuje strukturu a řetězce nového výstupu. |
| Předchozí zdroj | Umožňuje zjistit, zda se zdrojový řetězec na odpovídající cestě změnil. |
| Stávající cíl | Poskytuje překlady, které lze zachovat. |
Pokud jsou k dispozici předchozí zdroj a stávající cíl, každý nový nebo změněný zdrojový řetězec se zařadí k překladu. U nezměněného zdrojového řetězce lze znovu použít stávající cílovou hodnotu na odpovídající cestě. Dva klíče se stejným anglickým textem zůstávají samostatnými záznamy. Mohou mít různé schválené překlady, protože se liší jejich kontext.
Například změna checkout.title sama o sobě nevyžaduje opětovný překlad checkout.delivery. Pokud se zdrojová hodnota druhého klíče nezměnila a jeho cílová hodnota je k dispozici, lze ji převzít. Změna čísla nebo jiných dat určujících strukturu může přesto vyžadovat opětovné sestavení souboru, i když žádné nové řetězce k překladu nejsou.
Předchozí zdroj uchovávejte společně s odpovídajícím schváleným cílem. Pokud některý z nich chybí, obslužná rutina zpracuje řetězce jako při prvním průchodu. Tyto vstupy mezi jednotlivými běhy CLI propojují Lockfile a cache.
Zvolte, co se stane s chráněnými cestami #
Tato nastavení mají na výstup různé dopady:
| Nastavení | Chování při překladu | Chování ve výstupu |
|---|---|---|
| Uzamčená cesta | Vyloučena z překladu. | Převezme hodnotu z aktuálního zdroje. |
| Zachovaná cesta | Vyloučena z překladu. | Ponechá stávající cílovou hodnotu, pokud daná cesta v cíli existuje; jinak zachová zdrojovou hodnotu. |
| Ignorovaná cesta | Vyloučena z překladu. | Odstraní cestu z výsledného cíle. |
| Vložení jazyka | Nastavené pole pro jazyk je vyloučeno z překladu. | Zapíše do tohoto pole cílový jazyk. |
Sdílený identifikátor uzamkněte, pokud musí všechny jazyky používat zdrojovou hodnotu. URL specifickou pro daný cíl zachovejte, pokud má každý jazyk vlastní cílovou adresu. Poznámku určenou pouze pro zdroj ignorujte, pokud se nesmí objevit v přeloženém souboru. Tyto volby neznamenají totéž co „nepřekládat“.
Na stejné cestě má uzamčení přednost před zachováním, takže hodnota uvedená v obou seznamech se převezme ze zdroje. Ignorování hodnotu odstraní, i když je zároveň uzamčená, zachovaná nebo vybraná pro vložení jazyka. Vložení jazyka má na dané cestě přednost před uzamčením a zachováním. Každou hodnotu pokud možno řiďte jediným pravidlem. Pokud se pravidla v rámci objektu nebo pole překrývají, zkontrolujte výstup.
Odstraněním prvku pole se posunou pozice všech následujících prvků. Výsledné pole proto zkontrolujte jako data, nejen jako přeložený text. Vložení jazyka může vytvořit chybějící nadřazené objekty. Při zápisu do pole použijte existující prvek nebo pozici bezprostředně za koncem pole. Zápis selže, pokud cesta vytváří mezery nebo prochází nekompatibilní hodnotou.
Tato nastavení zadáte pomocí polí v záznamu souboru pro CLI nebo voleb v záznamu souboru pro GitHub.
Rozsah aktualizací a omezení při opětovném sestavení #
Aktualizace klíčů sloučí vybrané překlady se stávajícím cílem. Nevybrané cílové hodnoty a klíče existující pouze v cíli zůstanou beze změny a vynechané položky zůstanou vynechané. Klíče, které existují pouze ve zdroji a leží mimo vybraný rozsah, se nepřidají. Zápisy do pole nesmějí vytvářet mezery. Například výběr druhého prvku pole za vás nedoplní chybějící první prvek. Po částečné aktualizaci zkontrolujte celý cíl.
Výstup JSON se serializuje s odsazením dvěma mezerami a znakem nového řádku na konci. Neočekávejte, že se bílé znaky nebo komentáře zachovají bajt po bajtu. U zdrojových souborů s komentáři si přečtěte část JSONC. Než budete přepsaný soubor považovat za rovnocenný původnímu, ověřte požadavky systému, který ho zpracovává.
Překladové workflow kontroluje podporované zástupné symboly a strukturu ICU, včetně změněných nebo chybějících argumentů. Projděte nahlášená varování nebo chyby a poté schválenou šablonu vykreslete s hodnotami z aplikace. Tyto kontroly neposuzují, zda přeložená zpráva vyjadřuje zamýšlený význam.
Načtěte výstup v aplikaci s reprezentativními hodnotami. Ověřte, že chráněné cesty zachovávají požadovaná zdrojová nebo cílová data a že zpráva o doručení i po dosazení hodnot vyjadřuje stejný příslib. Parsování ověří syntaxi JSON; vykreslením a přečtením ověříte sdělení, které se dostane k lidem.