Znovu přeložte vybraný obsah pomocí CLI v0
Obnovte starší překlady po změnách zdroje nebo instrukcí, zachovejte kontrolu nad rozsahem a chraňte přijaté úpravy.
Když se změní zdrojový obsah, použijte běžné spuštění. Vynucené spuštění použijte, pokud zdroj zůstává stejný, ale překlad má zohlednit nové instrukce nebo nahradit nevyhovující hodnotu. Obě varianty mohou přepsat běžné ruční úpravy.
Nechte změny zdroje určit rozsah běžného zpracování #
lingo run| Stav zdroje a cíle | Výsledek běžného spuštění v0 |
|---|---|
| Zdrojová hodnota se oproti předchozímu kontrolnímu součtu změnila | Přeloží se změněná hodnota. |
| Zdrojový klíč v cíli chybí | Přeloží se chybějící obsah. |
| Zdrojový klíč byl odstraněn | Odstraní se odpovídající spravovaná položka v cíli. |
| Kontrolní součet zdrojové hodnoty nového klíče odpovídá kontrolnímu součtu zdrojové hodnoty odstraněného klíče | V daném kontextu zpracování se znovu použije překlad. |
| Cílová hodnota existuje a zdroj se nezměnil | Cílová hodnota se zachová. |
Běžná ruční oprava zůstane zachována, pokud se zdroj nezmění, ne však při každé budoucí aktualizaci. Chráněné klíče vyhrazují samostatnou hodnotu pod lidskou správou.
Obnovte jeden dotčený překlad #
Po změně modelu, promptu, glosáře nebo pravidla začněte dotčeným jazykem a klíčem:
lingo run --force --target-locale es --key welcome/titleZde welcome/title označuje title v rámci welcome. V 0.138.10 přijímá příkaz run přesné klíče, prefixy respektující hranice klíčů a vzory glob. Uzavřete --key 'welcome/**' do uvozovek, abyste vybrali podřízené položky, aniž by vzor rozvinul shell.
Porovnejte překlad se zdrojem a poté jej načtěte v aplikaci. Zpracování omezené na konkrétní jazyk nebo klíč neaktualizuje stávající sdílený výchozí stav. Dodržujte pravidla pro sladění souboru Lockfile, aby pozdější běžné spuštění nečekaně nezpracovalo tutéž změnu zdroje znovu.
Ve velkém projektu zvolte zvládnutelný rozsah práce #
--target-locale, --bucket, --file a --key jsou selektory, které můžete zadat opakovaně. --source-locale mění zdroj použitý pro dané spuštění. Vycházejte ze seznamu nakonfigurovaných skupin a cest a výběr postupně zužujte, místo abyste zadávali libovolný soubor mimo konfiguraci.
lingo run --target-locale es --bucket json --file 'apps/web/**'Příkaz run umožňuje vybírat soubory podle podřetězců nebo vzorů minimatch, které porovnává s nalezenými nakonfigurovanými cestami. Příkaz purge vybírá soubory pouze podle podřetězců a liší se i jeho způsob výběru klíčů. Nepřebírejte selektory z jednoho příkazu do druhého bez kontroly vybraných položek.
Pokud chcete záměrně provést širší obnovu:
lingo run --force --bucket json --target-locale esTím můžete znovu vygenerovat veškerý vybraný obsah ve španělštině ve formátu JSON. Samotné lingo run --force zahrnuje celý nakonfigurovaný projekt. Před rozšířením rozsahu si uchovejte přijaté výstupy a při použití backendu Lingo.dev proveďte odhad pro stejný rozsah vynuceného spuštění.
U rozsáhlých změn usnadní kontrolu rozdílů samostatné vymezení souborů a jazyků. Po selhání zachovejte výstupy úspěšně zpracovaných částí a zopakujte zpracování příslušného rozsahu, než vynutíte nové zpracování všeho. Paralelní zpracování řídí propustnost, nikoli výběr ani vracení změn.
Katalogy uživatelského rozhraní a dokumenty uchovávejte v oddělených skupinách podle formátu a vylučte generovaný i rozpracovaný obsah. Pokud se liší cíle nebo lokalizační engine, použijte samostatné konfigurace balíčků. V CI příkaz lingo run --frozen kontroluje důvěryhodný výchozí stav bez překládání. Příčiny selhání prošetřete, místo abyste je potlačovali přepočítáním kontrolních součtů. Aktuální postup pro spouštěč používá jiný balíček a konfiguraci, proto před jeho nasazením proveďte migraci.
Příkaz purge používejte jen tehdy, když chcete obsah odstranit #
Dříve používaný postup purge následovaný příkazem run odstraní cílové klíče, aby je běžné doplňování chybějícího obsahu znovu zpracovalo. Výstupy ale maže ještě před úspěšným opětovným vygenerováním a jeho přínos pro výkon není prokázán. V referenční dokumentaci příkazu purge si ověřte odlišnosti jeho selektorů i riziko pro zdrojový jazyk. Dokud opětovné vygenerování a kontrola úspěšně neskončí, uchovejte kopii pro případnou obnovu.