lingo push
Odešlete změny zdrojů, doplňte chybějící cílové soubory nebo cíleně obnovte vybrané překlady.
Po nastavení prvního souboru používejte pro běžné úpravy zdrojů lingo push --wait. CLI porovná zdrojová data s výchozím stavem po bajtech, vyžádá zpracování změn a stáhne dokončené cílové soubory. Zdroje shodné bajt po bajtu přeskočí.
Ostatní režimy slouží k jiným úkolům. Vybírejte je podle toho, co se má změnit — ne každý push znamená úplný překlad.
Vyberte, co zpracovat #
| Volání | Chování |
|---|---|
| Běžný push bez platného výchozího stavu | Uloží zdrojová data po bajtech; počáteční překlad automaticky nevyžádá. |
| Běžný push s výchozím stavem | Překládá změny zdrojů přírůstkově. |
lingo push 'locales/en.json' | Plánuje zpracování v určeném rozsahu bez běžného porovnání s předchozí verzí zdroje; stávající cílové soubory lze převzít. |
lingo push --backfill-missing | Vytvoří chybějící cílové soubory pro nakonfigurované zdroje. |
Push v určeném rozsahu s --force | Znovu vygeneruje vybrané cílové překlady ve formátech se samostatnými soubory, aniž by zachoval kontext stávajícího překladu. |
Push s --key | Vybere jednotky se stabilními klíči ve stávajících cílových souborech; opětovné použití nezměněných hodnot závisí na formátu. |
Doplnění chybějících souborů nepřidává nové ani změněné klíče do běžného cílového souboru, který už existuje. Upozorní na změny zdroje oproti výchozímu stavu. Aby překlady do stávajících jazyků zůstaly aktuální, dokončete tyto běžné aktualizace příkazem push ještě před doplněním. Dokument, který pokrývá jen část nakonfigurovaných jazyků, zachovává stávající výchozí stav zdroje, takže pozdější běžný push může zpracovat čekající úpravy pro ostatní jazyky. Sdílené katalogy XCStrings používají plánování podle jazyka. Vzory zadané jako poziční argumenty omezují výběr na průnik s konfigurací, neumožňují tedy zpracovat libovolné soubory.
Volby #
| Volba | Účinek |
|---|---|
| Vzory v pozičních argumentech | Vyberou nakonfigurované soubory; vzory se zástupnými znaky pro shell uzavřete do uvozovek. |
--force, -f | Nahradí překlady celých souborů; použijte výslovně zadané vzory souborů nebo doplnění chybějících souborů. |
--backfill-missing | Vytvoří chybějící cílové soubory. |
--key <pattern> | Vybere jednotky se stabilními klíči; volbu lze zadat opakovaně. |
--yes, -y | Přeskočí potvrzení vynuceného přepsání. |
--wait, -w | Počká a stáhne výstup, místo aby se příkaz ukončil hned po odeslání. |
--estimate | Naplánuje zpracování a vyčíslí náklady bez překládání či vytvoření úlohy. |
--with <stage> | Spustit fázi pouze pro toto odeslání; lze zadat opakovaně. |
--without <stage> | Přeskočit fázi pouze pro toto odeslání; lze zadat opakovaně. |
--review-*, --content-length | Upravit nastavení fáze pouze pro toto odeslání. |
Logické přepínače mají výchozí hodnotu false. Cíle se přebírají z konfigurace; push nemá přepínač pro jazyk. Vynucené přepsání celých souborů vyžaduje potvrzení, pokud ho nepotlačí volba yes, omezení rozsahu na klíče nebo odhad. Bez vzorů v pozičních argumentech vybere --force všechny nakonfigurované zdrojové soubory a cílové jazyky. Před rozsáhlým přepsáním zadejte konkrétní vzory souborů a zkontrolujte rozsah pomocí --estimate. Vynucené přepsání může přepsat i ruční úpravy cílových souborů, protože u formátů se samostatnými soubory vymaže kontext aktuálního překladu. Katalogy XCStrings a tabulky CSV mohou i nadále znovu použít překlady uložené ve sdíleném zdrojovém souboru.
Obnovte vybrané klíče #
Obnovení klíčů použijte, pokud se změnily uložené pokyny, ale zdrojový text zůstal stejný, nebo pokud potřebujete znovu přeložit konkrétní podmnožinu:
lingo push 'locales/en.json' --key 'checkout.title' --key 'checkout.submit' --waitKlíče se zapisují jako cesty s tečkovou nebo závorkovou notací. Výběr objektu zahrnuje všechny řetězce pod ním: auth.login zahrnuje auth.login.title, ale ne auth.login_url. * zastupuje jeden celý segment. Funguje i zápis s lomítky ze starší verze CLI, například auth/login. JSON, JSONC, TypeScript a PHP znovu vygenerují vybrané řetězce, i když se jejich zdroj nezměnil. YAML a YAML s kořenovými klíči podporují výběr klíčů, ale mohou znovu použít aktuální cílové hodnoty, pokud jejich zdroj odpovídá uloženému výchozímu stavu. Chcete-li opravit formulaci v YAML, upravte cílový soubor přímo. Pro rozsáhlejší přegenerování po změně pokynů uložte přijaté cílové překlady a použijte --force pro celý soubor bez --key.
Chybějící cílové jazyky a formáty bez stabilních klíčů se přeskočí s příslušným hlášením; ostatní formáty zastaví push s chybou. Chybějící cílové soubory vytvořte samostatně. Přidání --force k --key nemění plánování podle klíčů ani nebrání opětovnému použití hodnot v YAML.
Push omezený na vybrané klíče ponechá výchozí stav celého zdroje beze změny, ať už jeho výstup stáhne push --wait, nebo pozdější pull. Čekající běžné úpravy zdroje se tak zpracují při dalším běžném spuštění příkazu push. V části Rozsahy najdete matici podpory formátů a syntaxi klíčů.
Před rozsáhlým přepsáním proveďte odhad #
lingo push 'locales/en.json' --force --estimateOdhad naplánuje přesný rozsah změn bez překládání či vytvoření úlohy. Nahraje soubory, které server pro daný plán nemá, takže jde o volání služby, nikoli o zkušební běh offline. Nenahrazuje uložený ukazatel pro pull ani výchozí stav dokončeného zpracování. První push pouze uloží zdroje, takže jeho odhad oznámí, že není co odhadovat, a odkáže na lingo push --estimate --backfill-missing.
Výstup uvádí plánované náklady, překlady k vytvoření a opětovnému použití, výstupní tokeny a rozpis po jednotlivých jazycích. Případné náklady na následné opravy a výdaje účtované vaším vlastním poskytovatelem AI se zobrazují na samostatných řádcích a do plánovaného součtu se nezahrnují. Následující upozornění uvádějí, co odhad nezahrnuje. Částky označené ~ jsou přibližné. Popisují plán, nikoli naměřenou spotřebu nebo cenovou nabídku. Pokud je push na provedení odhadu příliš rozsáhlý, selže s uvedením důvodu ze serveru; zadáním vzorů souborů můžete odhadnout jen jeho část.
Změna fází pro jedno odeslání #
lingo push 'locales/en.json' --force --wait --with human-review --review-level strict --review-timeout 12 --without pre-editPřepínače fází mění pipeline daného engine pouze pro toto odeslání. Můžete si tak vyzkoušet konfiguraci, aniž byste engine museli upravovat nebo znovu vytvářet. Všechna nastavení, která přepínače neurčují, se přebírají z engine, včetně skupin pro lidskou kontrolu.
--with a --without přijímají hodnoty pre-edit, rephrase, human-review, post-edit, content-length nebo back-translation. Překlad se spouští vždy. --without přeskočí i fáze, které závisejí na přeskočené fázi: --without human-review přeskočí AI hodnocení a následné úpravy.
| Nastavení | Hodnoty |
|---|---|
--review-level | everything odešle kontrolorům všechny jednotky; strict, medium nebo lax odešle pouze jednotky, které AI hodnocení označí danou úrovní závažnosti. |
--review-pool <name> | Pro kontroly se použije tato skupina místo skupin nastavených v engine. |
--review-languages <locales> | Seznam jazyků oddělených čárkami, které kontroluje skupina --review-pool; ve výchozím nastavení všechny jazyky. |
--review-timeout <hours> | Počet hodin, které mají kontroloři k dispozici. |
--content-length <rule> | source, match:<percent> nebo max:<columns>. |
Nastavení fázi upraví, ale nezapne ji. Pokud se tedy fáze nespustí, odeslání selže: přidejte --with human-review nebo --with content-length. --with human-review u engine bez skupin pro kontrolu vyžaduje --review-pool. Pokud požadujete fázi, kterou váš plán nezahrnuje, odeslání selže, místo aby se fáze přeskočila. Výsledky se zapisují jako při každém jiném odeslání; přidejte --force nebo --key, aby se znovu přeložily i nezměněné jednotky, a --estimate, abyste nejprve zjistili náklady na danou konfiguraci. Při opakovaném pokusu je nutné znovu zadat stejné přepínače fází.
Před přidáním nového jazyka nejprve dokončete běžné aktualizace zdrojů pro stávající cílové soubory. Poté jazyk přidejte do targetLocales, zkontrolujte lingo push --backfill-missing --estimate a vyžádejte doplnění chybějících souborů beze změny revize zdroje. Návod Přidání jazyka vás provede tímto postupem až po kontroly v aplikaci. Odebráním jazyka ho vyřadíte z budoucího výběru, soubory se ale nesmažou. Na sdílené katalogy XCStrings nepoužívejte promazání jazyka.
Stáhněte výstup a obnovte zpracování #
Pokud nepoužijete čekání, zachovejte checkout i ukazatel uložený na daném počítači, dokud pull nestáhne výstup. Další push může tento ukazatel nahradit. Při použití čekání zkontrolujte neúspěšné či částečně neúspěšné výsledky i skutečně stažené soubory. Čekání skončí, jakmile všechny nedokončené cíle čekají na lidskou kontrolu; po jejím dokončení spusťte pull. Během přímého stahování výstupu v režimu čekání neupravujte cílové soubory. Na rozdíl od příkazu pull se při něm znovu neporovnávají ruční úpravy.
Chcete-li zopakovat neúspěšné zpracování, odstraňte příčinu a postupujte podle postupu obnovy po neúspěšném běhu: zopakujte příslušný push se zachovaným stavem, ověřte vypsané ID úlohy a poté zkontrolujte výsledný výstup. Pokud výstup předchozího příkazu push ještě nebyl stažen a požadavek se nezměnil, push znovu použije původní požadavek, místo aby vytvořil duplicitní: k běžící úloze se znovu připojí, z dokončené stáhne výstup a neúspěšnou nahradí novou úlohou.