Jak obnovit přerušený běh lokalizace
Zjistěte, co odeslaný běh skutečně dokončil, stáhněte dostupné výsledky a při řešení zbývající práce zachovejte ruční opravy.
Samotné zavření terminálu během lingo push --wait server nezastaví. Překlad může stále probíhat, čekat na kontrolu nebo už být hotový. Než stejný obsah odešlete znovu, zjistěte, v jakém je stavu.
Tento průvodce se věnuje již odeslané práci. Pro novou opravu použijte aktualizaci s omezeným rozsahem. Pokud potřebujete schválené cílové překlady zachovat i při běžných změnách, řiďte se pokyny k jejich zachování.
Uchovejte záznamy a lokální stav #
Poznamenejte si vypsané ID běhu, revizi zdroje, vybrané soubory a jazyky i poslední známý stav. Zachovejte stav běhu uložený v checkout, soubor Lockfile i veškeré ruční úpravy cílových překladů. Pokud tyto záznamy nejprve smažete, můžete přijít o informace potřebné k obnovení práce.
U běhu odeslaného pro dva cílové jazyky prověřte každý jazyk zvlášť. Nepředpokládejte, že ztráta spojení s terminálem přerušila práci na obou ve stejném bodě.
Než začnete znovu, prověřte možnosti stažení výsledků #
V checkout, ze kterého jste práci odeslali, použijte zaznamenaný běh:
lingo pull --dry-runTím ověříte, co by se zapsalo do lokálních souborů, aniž byste je změnili. Příkaz může průběžně zjišťovat stav nedokončené práce a hlásit čekání na kontrolu, selhání nebo dostupný výstup. Pull zapíše každý dokument, jakmile jsou dokončené všechny jeho jazyky. Dokumenty čekající na lidskou kontrolu ponechá beze změny; po dokončení kontroly jej spusťte znovu. Povinnou kontrolu vyřešte v příslušném workflow, místo abyste zdroj opakovaně odesílali.
Jakmile je výstup připravený, zkontrolujte konflikty a poté jej stáhněte:
lingo pullPull pracuje s lokálně zaznamenaným stavem; nevyhledává libovolné běhy z jiného počítače. Překlady, které byly jinde zapsány do systému správy verzí, převezměte prostřednictvím tohoto systému. Referenční dokumentace ke stavu běhu a Pull popisují konkrétní soubory a pravidla pro řešení konfliktů v nainstalované verzi CLI.
Zopakujte neúspěšnou práci pomocí push #
Po odstranění nahlášené příčiny zopakujte původní push se stejnými argumenty z checkout, ze kterého jste práci odeslali. Pro běžnou aktualizaci zdroje:
lingo push --waitPokud jste výsledky předchozího push ještě nestáhli a požadavek se nezměnil, push naváže na předchozí požadavek, místo aby stejnou práci odeslal podruhé. Ke stále běžící úloze se znovu připojí, výsledky dokončené úlohy stáhne a neúspěšnou úlohu nahradí novou s novým ID. Dokumenty stažené před selháním jsou už zaznamenané v souboru Lockfile, takže opakovaný pokus vyžádá jen práci, která stále chybí nebo se změnila.
Po opakovaném pokusu zkontrolujte výsledky pro jednotlivé cílové jazyky i stažené soubory a zjistěte, co ještě zbývá. Než ve stávajícím projektu doplníte chybějící cílové soubory, dokončete běžné aktualizace zdroje pro stávající cílové jazyky, stáhněte jejich výsledky a zkontrolujte je. Při doplňování chybějících souborů pomocí lingo push --backfill-missing --wait ponechte tuto revizi zdroje beze změny; postup vysvětluje část Přidání jazyka. Změněné klíče ve stávajících souborech naopak vyžadují odpovídající běžnou aktualizaci nebo aktualizaci s omezeným rozsahem.
Zvolte nápravu podle typu selhání #
Chybějící lokální záznam není totéž co neúspěšný běh na serveru. Neplatný obsah je třeba opravit, při zamítnuté autorizaci je nutné získat přístup a čekání na kontrolu vyžaduje rozhodnutí. Pokud je síťová odpověď nejednoznačná, před dalším odesláním ověřte, zda server práci přijal.
Neměňte zdroj jen proto, abyste mohli neúspěšný běh zkusit znovu. Uchovejte původní ID běhu a ověřte, že se nově vypsané ID úlohy liší. Postup obnovení v CLI popisuje ověření výstupu i postup kontaktování podpory, pokud se vrátí stejná neúspěšná úloha.
U částečných výsledků zachovejte úspěšné cílové překlady, které prošly kontrolou, a neúspěšné cílové překlady uveďte zvlášť. Pokud je potřeba nový běh, zaznamenejte, proč navazuje na předchozí běh nebo jej nahrazuje a kterou revizi zdroje používá. Předejdete tak záměně opožděného výsledku za aktuální výstup.
Vyřešte rozdíly v lokálních souborech #
Pull může odmítnout nahradit cílový překlad, který se od zaznamenané verze změnil. Porovnejte ruční úpravu i příchozí výstup s příslušnými revizemi zdroje a poté při kontrole rozhodněte, které znění schválíte.
lingo pull --force tuto ochranu obchází a přepisuje cílové překlady, které se od zaznamenané verze liší. Nejdříve si uložte lokální práci a výslovně se rozhodněte pro nahrazení. U sdílených katalogů chraňte celý soubor včetně zdroje a jazyků, kterých se změny netýkají.
Dokončete obnovení s použitelným výstupem #
Porovnejte cesty ke staženým souborům, jazyky, proměnné i rozdíly mezi verzemi. Načtěte výsledek v příslušné aplikaci nebo nástroji pro vykreslování a zkontrolujte jeho význam. To, že lze soubor stáhnout, ještě neznamená, že je schválený k použití.
Uchovejte ID obnoveného běhu, schválenou revizi, soubor Lockfile a cílové překlady jako nový výchozí stav. Obnovení je dokončené teprve tehdy, když jsou všechna zbývající selhání vyřešená nebo zdokumentovaná a schválený výstup odpovídá zamýšlenému zdroji — ne jen tehdy, když jeden příkaz úspěšně skončí.