Přejděte na aktuální CLI
Nahraďte starší buckety a otisky zdrojového obsahu a zachovejte přitom schválené překlady i funkční aplikaci.
Aktuální @lingo.dev/cli zpracovává operace push/pull na serveru a používá stav projektu .lingo. Starší balíček lingo.dev zpracovává buckety lokálně a používá i18n.json a i18n.lock. Migrace znamená zachovat chování, které projekt potřebuje, ne jen změnit název příkazu.
Zachovejte funkční výchozí stav #
Zaznamenejte nainstalovanou verzi a uložte zdrojové soubory, schválené cílové soubory, konfiguraci a starý Lockfile do systému správy verzí. Ověřte, že aplikace tyto cílové soubory načítá. Router, provider, přepínač jazyků a zavaděč katalogů stávajícího lokalizačního řešení zachovejte, dokud nebude fungovat náhrada v jasně vymezeném rozsahu.
Zaznamenejte verze frameworku a běhového prostředí i povinné zdrojové, cílové a výchozí jazyky. Otestujte reprezentativní trasy s jazykovou předponou, počáteční detekci, záložní chování a přepínání jazyků. Tyto kontroly aplikace provádějte odděleně od migrace překladu souborů.
Znovu nastavte výběr souborů #
Vytvořte .lingo/config.json se zdrojovými a cílovými jazyky a výslovně uvedenými položkami souborů. Poté propojte organizaci a lokalizační engine, ke kterým máte oprávnění. Starší buckety a otisky nelze převést do tohoto schématu pouhým přejmenováním.
Aktuální konfigurace CLI podporuje 22 formátů včetně HTML (.html a .htm), prostého textu (.txt, jedna jednotka na řádek jako ve v0), tabulek CSV, v nichž má každý jazyk vlastní sloupec v jednom souboru, a souborů Java .properties (jedna jednotka na klíč jako ve v0, přičemž lockedKeys, preservedKeys a ignoredKeys se porovnávají stejně jako ve v0 a lockedPatterns používá syntaxi RE2, která nepodporuje kontroly okolního textu ani zpětné reference). Než soubor z bucketu csv ve v0 přesunete, ověřte, zda odpovídá struktuře CSV. Cesty v bucketu properties ve v0 porovnejte s dokumentací Java properties: název souboru [locale], například messages_[locale].properties, se změní na vzor pro zdrojové soubory, například messages_en.properties. Buckety se samostatným CSV pro každý jazyk, buckety MJML a další buckety podporované pouze ve starší verzi vyžadují ověřený převod nebo jiný postup překladu. Přesné hodnoty výčtu, pravidla porovnávání a výstupní šablony najdete v části Konfigurace. Nastavení modelu, promptu a základní URL pro přímé připojení k poskytovateli z v0 do tohoto schématu projektu nepatří.
Než konfiguraci rozšíříte, zkontrolujte jeden vybraný zdrojový soubor a odvozené cesty k jeho cílovým souborům. Pro vlastnosti formátů z rodiny Markdown použijte translateComponentProps.
Převezměte a aktualizujte překlady #
Aktuální plánování pro omezený rozsah nebo počáteční nastavení umožňuje převzít stávající cílové soubory. Než je stanovíte jako výchozí stav, zkontrolujte reprezentativní soubory a ruční úpravy: samotná existence souborů nezaručuje, že jejich hodnoty odpovídají nejnovějšímu zdroji.
Zpětné doplnění doplňuje chybějící běžné soubory, zatímco v0 obvykle doplňuje chybějící klíče ve stávajících katalozích. Pro tyto následné úpravy použijte aktuální přírůstkové aktualizace zdroje nebo podporovanou obnovu klíčů. Přejmenovaný klíč JSON se považuje za novou položku ke zpracování podle cesty, i když má stejný text jako starý klíč. Nespoléhejte na opětovné využití překladu při přejmenování na základě otisku obsahu, jaké nabízela v0.
Úpravy cílových hodnot u nezměněných klíčů lze při přírůstkovém zpracování zachovat. Výslovná pravidla pro zachování klíčů navíc umožňují samostatně určit, kdo je spravuje. U formátů se samostatnými soubory vynucené zpracování celého souboru odstraní kontext aktuálního cílového souboru a může přepsat schválené znění. Není tedy zkratkou k převzetí stávajících překladů.
Dokončete první spuštění aktuální verze #
Projděte aktuálního průvodce rychlým startem až po zpětné doplnění a stažení souborů. Samotný první push bez výchozího stavu uloží zdrojová data v bajtech, místo aby vyžádal počáteční překlady. Než budete workflow pro soubory považovat za dokončené, vyčkejte nebo proveďte pull.
Schválené zdrojové a cílové soubory, konfiguraci a aktuální Lockfile zahrňte do jednoho commitu. Ukazatel na poslední spuštění zůstává lokálně v domovském adresáři a přes Git se nepřenáší. Při následném příkazu pull se porovnají hashe; samotné zahrnutí odlišné úpravy do commitu tento konflikt nevyřeší. lingo check nahrazuje dřívější kontrolu neměnnosti Lockfile na úrovni souborů: skončí chybou, pokud se zdroj od .lingo/lock.json změnil nebo chybí cílový soubor, a chybějící Lockfile nikdy nevytvoří. Pokud Lockfile není zahrnutý v commitu, příkaz nedokáže rozpoznat změny zdroje a kontroluje pouze to, zda cílové soubory existují.
Migrace Reactu #
Aktuální workflow pro React extrahuje volání s literály zdrojového textu a kontextu do JSONC a deklarací, přeloží vybrané katalogy a poté za běhu načte mapu řetězců. Než změnu rozšíříte, ověřte u jedné komponenty záložní chování, proměnné, přepínání jazyků a schválené znění.
Postup pro konkrétní balíček najdete v dokumentech Migrace stávajících zpráv v Reactu a React. Přibalený lingo guide migrate odpovídá nainstalované verzi; nezaručuje shodu se všemi dříve vygenerovanými konfiguracemi.