Řešení problémů s CLI
Vyřešte problémy s výběrem souborů, výchozím stavem, vyzvedáváním výsledků a katalogy, aniž byste nejprve smazali užitečná stavová data.
Při hledání příčiny selhání mějte po ruce číslo nainstalované verze, použitý příkaz, pracovní adresář, chybové hlášení a dotčené cesty. Před sdílením logů odstraňte přihlašovací údaje: diagnostické výpisy při spuštění i selhání mohou obsahovat nezpracované argv.
Žádné zdrojové soubory neodpovídají zadání #
Najděte nejbližší .lingo/config.json. Příkaz spuštěný ve vnořeném adresáři může používat projekt z některého z nadřazených adresářů. Nejprve zkontrolujte include, teprve pak pattern, protože i prázdné pravidlo pro zahrnutí má před ním přednost. Vyloučení platí pro každou položku zvlášť; jiná položka může soubor přesto vybrat.
Používejte podporovanou syntaxi pro porovnávání vzorů, například docs/en/**/*, vzory pro shell uzavírejte do uvozovek a zkontrolujte podporu přípon. YAML vyžaduje výslovné uvedení yaml, yaml-root-key nebo yaml-openapi; Android XML vyžaduje android. Soubor .txt, .csv nebo .properties potřebuje vzor končící jeho příponou, případně "format": "txt", "format": "csv" nebo "format": "properties"; obecný vzor jako docs/en/**/* ho přeskočí a položka txt, csv nebo properties přeskočí všechny soubory bez dané přípony. Ani výslovné zadání formátu neumožňuje použít libovolnou příponu.
Výstup se uložil na nesprávné místo #
Přečtěte si varování o odvozování cest a porovnejte cílovou cestu s tím, odkud soubory načítá vaše aplikace. Pokud se v cestě nerozpozná segment zdrojového jazyka, definujte targetPath a sourceRoot a nespoléhejte na náhradní postup s vložením jazyka. Cílové soubory ukládejte mimo cesty prohledávané při hledání zdrojů a zkontrolujte případné kolize.
Samotné přesunutí souborů výchozí stav neaktualizuje. XCStrings záměrně používá jeden sdílený zdrojový katalog; nejde o běžné uspořádání se samostatnými soubory pro každý jazyk. Viz výstupní cesty.
Volba nemá žádný účinek #
Neznámé klíče na kořenové úrovni nebo na úrovni souboru vyvolají varování a ignorují se. Zkontrolujte jejich zápis a to, které volby vybraný obslužný modul skutečně podporuje. Nastavení cest katalogu neaktualizuje vzory pro push a příkazy extract a check nastavují výchozí zdrojový jazyk nezávisle na sobě na en.
Lokální hodnocení používá spustitelný soubor lingo.config.ts, nikoli JSON projektu. Volba ochrany pro JSON nemusí mít vliv na Markdown ani jiné formáty.
Chybí artefakt výchozího stavu #
Předchozí zdrojový artefakt určený hashem v souboru Lockfile musí existovat lokálně nebo na serveru. Zkontrolujte příslušnou položku a obnovte obsah, o němž víte, že je správný, nebo konzistentní výchozí stav. Nevymýšlejte si hash ani nemažte celý Lockfile jen proto, abyste chybu skryli.
Pokud stav chybí, běžný první push uloží zdrojová data; chybějící běžné cílové soubory je nutné zpětně doplnit. Část Lockfile a cache vysvětluje, který záznam daná operace potřebuje.
Pull hlásí konflikt #
Spusťte lingo pull --dry-run a prohlédněte si rozhodnutí o zápisu. Cílový soubor blokuje zápis, pokud neodpovídá výstupu serveru, obsahu zachycenému při push ani hashi v souboru Lockfile. Zahrnutí souboru do commitu výsledek porovnání nezmění.
Úpravu zachovejte a slučte s ostatními změnami, obnovte známou verzi nebo zvolte vynucení, ale jen pokud chcete obsah záměrně nahradit. Během push --wait cílové soubory neupravujte: na rozdíl od pull se při něm neprovádí nová kontrola konfliktů.
Zpracování selhalo nebo zůstalo nedokončené #
Projděte chyby jednotlivých cílů a rozlišujte mezi čekajícím zpracováním, kontrolou, selháním a chybějícími výstupy. Při neúspěšném běhu skončí push --wait i pull s nenulovým návratovým kódem, ale nejprve zapíší dokončené dokumenty; ověřte proto stav i skutečné soubory.
Pokud všechny nedokončené cíle čekají na lidskou kontrolu, push --wait a pull přestanou čekat a oznámí to. Dokumenty, u nichž jsou hotové všechny jazyky, lze vyzvednout; po dokončení kontrol spusťte lingo pull znovu. Další push čekání na kontrolu nevyřeší.
Pokud běh selhal, odstraňte nahlášenou příčinu a zopakujte příkaz odpovídající dané práci. Pro běžné aktualizace zdroje použijte lingo push --wait s nezměněným zdrojem a zachovaným výchozím stavem. Zpětné doplnění chybějících cílových souborů opakujte až ve chvíli, kdy jsou existující cílové soubory aktuální, podle postupu Přidání jazyka. K samotnému vyžádání dalšího pokusu není potřeba upravovat zdroj, použít příznak vynucení ani mazat stav.
Push vypíše ID úlohy, kterou odešle nebo ke které se znovu připojí. Pokud výsledky předchozího push ještě nebyly vyzvednuty a požadavek se nezměnil, push použije stejný požadavek: běžící úloha si ponechá své ID a neúspěšnou úlohu nahradí nová. Uchovejte ID neúspěšné úlohy a ověřte, že další vypsaný řádek Job obsahuje jiné ID. To potvrzuje nové odeslání, nikoli úspěšný překlad: projděte výsledky jednotlivých cílů, stáhněte výstup a zkontrolujte rozdíly. Během --wait ponechte lokální cílové soubory beze změn; pokud potřebujete chránit ruční úpravy, spusťte push a pull samostatně, aby pull provedl kontrolu konfliktů.
Pokud nainstalovaný klient vrací stejnou neúspěšnou úlohu, přestaňte požadavky opakovaně odesílat a napište na support@lingo.dev. Uveďte verzi CLI, příkaz bez citlivých údajů, původní i vrácená ID běhů, revizi zdroje, dotčené jazyky a cesty, časová razítka a chybové hlášení bez citlivých údajů. Do zprávy nezahrnujte přihlašovací údaje, soukromý zdrojový text ani původní soubory s přihlašovacími údaji. Po dobu prošetřování selhání zachovejte lokální ukazatel na běh i soubor Lockfile.
Smazání ukazatele na běh není spolehlivý způsob, jak si vyžádat nový překlad; dokud nejsou výsledky push vyzvednuty, ukazatel uchovává identitu požadavku, která brání duplicitnímu odesílání. Pokud se žádný běh nenajde, zkontrolujte počítač, absolutní cestu ke kořenu projektu a to, zda ukazatel nenahradil jiný push.
Kontroly katalogu selhávají #
Příkaz extract spouštějte se stejným jazykem a cestami jako check. Než odstraníte osiřelé položky, projděte varování týkající se dynamických volání a volání přes destrukturované funkce. Chybějící cílový soubor se nahlásí pouze tehdy, když vzory files odpovídají zdrojovému katalogu; jinak porovnejte očekávané jazyky s existujícími soubory.
Vyčistěte pouze záměrně odebrané položky, znovu vygenerujte deklarace a poté spusťte check a sestavení aplikace. status je nyní součástí příkazu check; interní názvy služeb nejsou spustitelné příkazy.
Než cokoli smažete #
Purge zobrazí náhled odstranění cílových souborů. Filtry souborů a jazyků omezují mazání na vybrané cíle a jejich záznamy v souboru Lockfile; purge bez filtrů odstraní celý Lockfile. Sdílené katalogy XCStrings se přeskakují. Příkaz purge používejte jen tehdy, když je vaším záměrem samotné smazání. Většina postupů obnovy vyžaduje cílenou opravu, při níž zůstanou zachovány schválené formulace i stav, ze kterého lze data obnovit.