Lockfile pro CLI v0

Zjistěte, jak pomocí výchozího stavu zdroje ve starší verzi porozumět čekajícím změnám a obnovit stav, aniž byste skryli nedokončené překlady.

i18n.lock umožňuje verzi v0 rozlišit nezměněný zdroj od textu, který je třeba přeložit. Uchovávejte jej společně se zdrojem a schválenými cílovými texty, které popisuje. Nezaznamenává každou ruční úpravu cílového textu ani nepotvrzuje správnost překladu.

Co soubor zaznamenává #

V lingo.dev@0.138.10 má soubor formát YAML s version: 1 a mapováním checksums. Každá vnější sekce používá hash zpracovaného vzoru cesty; její položky přiřazují zdrojovým klíčům kontrolní součty zdrojových hodnot založené na MD5. Správu těchto položek přenechte CLI a nevytvářejte je ručně.

Při změně kontrolního součtu se existující klíč stává kandidátem na překlad. Shodné hashe zdrojových hodnot mohou také propojit nový klíč s odstraněným klíčem ve stejném kontextu zpracování, a umožnit tak opětovné použití překladu při přejmenování. Ani jeden z těchto mechanismů nefunguje jako neomezená překladová paměť napříč soubory.

Rozlišujte mezi překladem a nahrazením výchozího stavu #

OperaceCo dělá
lingo runPřeloží vypočtené rozdíly a aktualizuje stav zdroje.
lingo run --forceZnovu vygeneruje vybraný výstup, aniž by vycházela z běžně vypočtených rozdílů.
lingo lockfileDoplní chybějící sekce stavu zdroje a vyplněné sekce ponechá beze změny.
lingo lockfile --forceNahradí kontrolní součty zdroje podle aktuálních souborů, aniž by překládala cílové texty.
lingo run --frozenZkontroluje synchronizaci bez překladu, ale nejprve inicializuje chybějící výchozí stav.

Představte si, že se anglický text změní až po schválení francouzského překladu. Nahrazením jeho kontrolního součtu pomocí lockfile --force se nový anglický text zaznamená jako výchozí stav, přestože francouzský text může stále vyjadřovat původní význam. Opětovné vytvoření výchozího stavu proto není běžným řešením chyby synchronizace.

Spuštění omezená na cílový jazyk nebo konkrétní klíče mohou zapsat překlady, aniž by aktualizovala stávající sdílený výchozí stav zdroje. Pozdější běžné spuštění může tutéž změnu zdroje zpracovat znovu a přepsat opravu provedenou po spuštění s omezeným rozsahem. Než sdílený výchozí stav aktualizujete, pečlivě slaďte výstupy příslušných jazyků.

Při dokončování změny zdroje napříč několika jazyky:

  1. Neměňte revizi zdroje a zachovejte i18n.lock, dokud některý z dotčených výstupů zůstává nedokončený. Pro běžnou aktualizaci celého projektu použijte lingo run. Pokud výstupy vyžadují samostatnou práci a kontrolu, využijte zdokumentovaná spuštění s omezeným rozsahem.
  2. Zkontrolujte výstup každého jazyka, na který se nahrazení kontrolních součtů zdroje vztahuje, včetně výstupů, kterých se poslední spuštění s omezeným rozsahem nedotklo. Vyřešte chyby a slaďte schválené ruční opravy s daným zdrojem. Pokud je některý výstup stále zastaralý nebo u něj přetrvávají pochybnosti, aktualizaci sdíleného výchozího stavu odložte.
  3. Pokud práce s omezeným rozsahem ponechala stávající výchozí stav beze změny a všechny zahrnuté výstupy jsou nyní schválené, spusťte lingo lockfile --force ze zamýšleného kořenového adresáře projektu. Tento příkaz nahradí kontrolní součty zdroje bez překladu. Nepoužívejte jej proto k přeskočení předchozí kontroly ani nepředpokládejte, že poslední výběr cílového jazyka omezuje rozsah tohoto nahrazení.
  4. Zkontrolujte rozdíly v souboru Lockfile a do jednoho commitu uložte přesnou revizi zdroje, všechny odpovídající schválené cílové texty a i18n.lock. Pozdější lingo run --frozen může zkontrolovat synchronizaci vůči takto ustálenému výchozímu stavu, nemůže však ověřit aktuálnost cílových textů ani kvalitu překladu.

Pokud chybí i18n.lock, zmrazený režim není čistě jen pro čtení. Může nejprve inicializovat kontrolní součty a samotná přítomnost cílových klíčů aktuálnost nedokazuje. Než úspěšnou kontrolu ve zmrazeném režimu vyhodnotíte jako důkaz synchronizace, ověřte důvěryhodnost dvojice zdroje a cílového textu.

Obnovení chybějícího stavu nebo stavu s konflikty #

Když soubor Lockfile chybí, verze v0 nemusí znovu vygenerovat všechny existující cílové texty: bez předchozího kontrolního součtu může jejich hodnoty zachovat. Před přijetím nově vytvořeného výchozího stavu zkontrolujte dvojice zdroje a cílového textu, u kterých si nejste jistí. Tento případ převzetí popisuje část Existující překlady.

Při konfliktu během slučování nejprve slaďte změny zdroje a cílových textů z obou větví. Pokud je to možné, obnovte důvěryhodný soubor Lockfile. Pokud jej musíte vytvořit znovu, zkontrolujte samotné dvojice zdroje a překladu: opětovné vytvoření zaznamenává stav zdroje, nikoli aktuálnost cílových textů.

Postup opravy YAML ve starší verzi ponechá poslední z duplicitních položek a nahlásí odstranění. Tím vyřeší duplicity v syntaxi, nikoli to, z které větve pochází správné znění. Než opravený soubor uložíte do commitu společně se schválenými výstupy, zkontrolujte konfliktní hodnoty.