Jak při aktualizacích zachovat zkontrolované překlady

Uchovávejte výchozí verze zdroje a schváleného překladu společně, zvolte správný režim aktualizace a ověřte, co přesně se změnilo.

Za schváleným překladem je práce, kterou stojí za to zachovat. Když se změní jeden zdrojový řetězec, okolní řetězce mohou být stále správné. Opětovné použití je pomůže zachovat, pokud má workflow k dispozici správné výchozí verze a použije zamýšlený způsob slučování.

Samotné označení „přírůstková aktualizace“ tuto ochranu nevystihuje. Uchovávejte předchozí zdroj i schválený překlad, zvolte pravidla aktualizace pro daný způsob volání a zkontrolujte skutečné rozdíly. Pokud potřebujete provést konkrétní opravu překladu, použijte aktualizace jednoho klíče; pokud se odeslaná úloha zastavila, začněte obnovením.

Zaznamenejte, co se musí změnit a co musí zůstat zachováno #

Podívejme se na tento příklad zdroje:

json
{
  "retention": "Reports remain available for 30 days.",
  "support": "Contact support",
  "productName": "ExampleApp"
}

Vlastník zdroje změní dobu uchovávání na 60 dní. Uchovejte původní zdroj, nový zdroj i zkontrolovaný překlad. Doba uvedená v překladu se musí změnit, schválené znění support by ale mělo zůstat zachováno. Ponechat productName ve stejné podobě jako ve zdroji je jiný požadavek než zachovat zkontrolovanou formulaci překladu.

Uložte nejnovější schválenou revizi překladu včetně ručních úprav provedených od stažení a jejich odůvodnění. Výchozí verze na serveru a překlad v pracovním stromu už nemusí mít stejný obsah.

Pro změny zdroje používejte běžné plánování rozdílů #

Běžné spuštění lingo push --wait v aktuálním CLI plánuje změny podle zaznamenaného stavu zdroje a překladů. Konfiguraci, zdroj, schválené překlady i .lingo/lock.json uchovávejte v systému správy verzí. Smazáním souboru Lockfile změníte plánování; nejde o pouhé obnovení beze změny chování.

--backfill-missing doplňuje chybějící soubory překladů, nikoli každý chybějící nebo změněný klíč v existujících souborech. Vzory zdrojových souborů zadané jako poziční argumenty používají plánování s omezeným rozsahem a jinými pravidly pro opětovné použití. --force znovu vygeneruje vybrané překlady v samostatných souborech a může nahradit schválený text; sdílené katalogy XCStrings mohou nadále využívat překlady, které už obsahují. Než požádáte o nahrazení, vyberte vhodný postup podle referenční dokumentace příkazu push.

Před spuštěním ve větším rozsahu zkontrolujte rozsah změn a tam, kde to dává smysl, si nechte vytvořit odhad. Po stažení porovnejte změněnou hodnotu i okolní schválené hodnoty. To, zda se obsah zachoval, ověřujte podle výsledku, ne podle označení spuštění.

Rozlišujte uzamčení na zdrojový text a zachování překladu #

Pokud je tato funkce podporována, uzamčený klíč zkopíruje zdrojový text do překladu. Zachovaný klíč ponechá stávající hodnotu překladu. Uzamčením zkontrolovaného francouzského řetězce ho tedy můžete nahradit angličtinou; francouzské znění tím neochráníte.

Možnosti řízení klíčů se liší podle formátu. Vynechání klíče z výstupu je opět něco jiného. Hodnotu, u níž se změnily skutečnosti uvedené ve zdroji, byste neměli zachovávat bezpodmínečně, protože by v ní mohl zůstat zastaralý význam.

Při stahování zohledněte ruční opravy #

Před odesláním aktualizace uložte stávající opravy. Konkrétní verze překladu zachycená příkazem push může být v rámci této aktualizace nahrazena. Chcete-li odhalit úpravy provedené po odeslání, vynechte --wait a poté zkontrolujte lingo pull --dry-run. Příkaz pull porovnává lokální překlady se zachycenou verzí překladu a zaznamenanými hashi a může odmítnout přepsat pozdější úpravy; přímé stažení z push --wait tuto opětovnou kontrolu neprovádí.

Při konfliktu porovnejte ruční opravu, zaznamenaný překlad a příchozí výsledek s příslušnými revizemi zdroje. Opravu, která je stále platná, zachovejte v rámci běžného procesu kontroly. lingo pull --force použijte až po uložení ručních úprav a vědomém rozhodnutí obsah nahradit. Vynucení obejde ochranu, ale správné znění překladu za vás nevybere.

U sdílených katalogů Apple zachovejte celý soubor a zkontrolujte i jazyky, kterých se změna netýkala. Neodstraňujte soubor obsahující zdroj a několik jazyků, jako by šlo o postradatelný výstup překladu.

Po kontrole přijměte novou výchozí verzi #

V uvedeném příkladu ověřte, že nový překlad uvádí 60 dní, hodnota support zůstala zachována a productName se chová podle záměru. Proměnné a strukturu zkontrolujte v běhovém prostředí, které je používá. Porovnání verzí odhalí změny; jazyková kontrola určí, zda je nové tvrzení správné.

Schválený překlad uchovejte spolu s odpovídající revizí zdroje jako další výchozí verzi. Pokud má oprava změnit budoucí pokyny, rozhodněte o tom samostatnou úpravou glosáře nebo pravidla. Nepředpokládejte, že jediná schválená úprava naučí lokalizační engine novou zásadu.