Správa klíčů a ruční úpravy v CLI v0
Ve starších katalozích rozlišujte hodnoty řízené zdrojem, překlady spravované lidmi a běžné opravy.
Běžná ruční oprava a zachovaný klíč mají různou životnost. Verze v0 obvykle ponechá stávající cílovou hodnotu, dokud se její zdroj nezmění. Zachovaný klíč vyhrazuje hodnotu pro ruční správu, i když se zdrojový text změní.
Opravte běžný překlad #
Upravte přímo cílovou hodnotu a schválené znění uložte do commitu. Pokud se zdroj nezměnil, běžné rozdílové zpracování může hodnotu zachovat. Jakmile se změní kontrolní součet zdroje, lze daný klíč znovu přeložit. Vynucené zpracování může hodnotu nahradit i beze změny zdroje.
Tento postup použijte u oprav, jejichž význam je při změně zdroje potřeba znovu posoudit. U obsahu, který musí zůstat v lidské správě, zvolte zachování hodnoty a stanovte postup pro kontrolu změn zdroje.
Jasně určete, kdo hodnoty spravuje #
| Řídicí prvek | Chování výstupu ve starší verzi |
|---|---|
lockedKeys | Zkopíruje zdrojovou hodnotu, čímž může přepsat úpravu cílové hodnoty. |
ignoredKeys | Vyloučí vybraný obsah z překladu i výstupu. |
preservedKeys | Chybějící hodnotu doplní ze zdroje a poté cílovou hodnotu zachová pro ruční správu. |
{
"buckets": {
"json": {
"include": ["locales/[locale].json"],
"lockedKeys": ["brand/name"],
"ignoredKeys": ["internal/*"],
"preservedKeys": ["legal/terms"]
}
}
}V tomto příkladu zůstane název značky beze změny, interní položky zmizí a právní podmínky zůstanou v lidské správě. Nově zachovanou zástupnou hodnotu ve zdrojovém jazyce je stále nutné před vydáním přeložit. Pokud aplikace očekává ignorovaný klíč, zajistěte náhradní hodnotu nebo tento požadavek změňte.
Zkontrolujte překrývající se řídicí vzory, místo abyste předpokládali nezdokumentované pořadí jejich přednosti. Toto chování verze v0 se liší od současných prvků pro zachování cílových hodnot.
Adresujte vnořené a doslovné klíče #
Cesty ve starší verzi používají k procházení struktury lomítka. brand/name vybere name uvnitř brand; modules/ai.translation vybere doslovný klíč obsahující tečku uvnitř modules. Zástupné znaky se řídí pravidly staršího mechanismu porovnávání a je třeba je otestovat v požadované hloubce. Současnou syntaxi s tečkami a hranatými závorkami nelze použít jako náhradu.
Využijte překlad znovu při přejmenování #
Starší rozdílové zpracování dokáže v rámci stejné zpracovávané cesty spárovat hash zdrojové hodnoty nového klíče s předchozím hashem odstraněného klíče. Pokud text zůstane stejný, může se stávající cílová hodnota přesunout k přejmenovanému klíči bez nového překladu.
Změna klíče i zdroje znamená novou práci. Přesuny mezi nezávislými cestami nebo použití opakujících se shodných řetězců vyžadují kontrolu; toto párování není neomezenou překladovou pamětí. Současné identity v JSON vycházejí z cest a toto chování nepřebírají.
Pro záměrné nahrazení použijte Opětovný překlad a pro doplnění kontextu Poznámky pro překladatele. Ani jedna z těchto možností nenahrazuje rozhodnutí o tom, kdo spravuje výstupní hodnotu.