Referenční příručka CLI v0
Udržujte stávající projekt s i18n.json a zachovejte přitom schválené překlady i výchozí stav zdroje.
Tato příručka popisuje starší balíček lingo.dev a jeho workflow i18n.json/i18n.lock. Příklady platí pro 0.138.10. Při plánování migrace se držte verze zaznamenané v souboru Lockfile stávajícího projektu. Instalace nejnovější verze, která se průběžně mění, není reprodukovatelným způsobem obnovy.
U nového projektu začněte s aktuálním CLI. Jeho serverové workflow pro odesílání a stahování používá jiná pravidla pro správu stavu a výběr.
Jak probíhá spuštění nainstalované verze v0 #
Konfigurace bucketu určuje parser a vyhledává zdrojové i cílové soubory. Podle potřeby přitom rozbaluje [locale]. Parser extrahuje obsah a odděluje hodnoty, které rozpozná jako nepřekládané. Výpočet rozdílů porovnává zdrojové hodnoty, stávající cílové hodnoty a předchozí kontrolní součty zdroje a zjišťuje tak nové, změněné, odstraněné nebo přejmenované položky.
Vybraný text zpracuje lokalizační engine Lingo.dev nebo nakonfigurovaný přímý poskytovatel. Z vrácených překladů se znovu sestaví cílové soubory nebo jazykové sekce sdíleného souboru. Úlohy mohou zapsat úspěšně zpracovaný výstup ještě předtím, než jiná úloha selže. Zpracování celého projektu tedy není atomickou transakcí.
Uchovávejte výchozí stav společně s obsahem #
Ukládejte i18n.json, schválené výstupy pro jednotlivé jazyky a i18n.lock společně do jednoho commitu. Soubor Lockfile zaznamenává stav zdroje, nikoli každou úpravu cílového textu nebo schválení jazyka. Běžná spuštění aktualizují kontrolní součty zdroje. Spuštění omezená na cílový jazyk nebo klíče mohou zapsat výstup, aniž by aktualizovala stávající výchozí stav.
Referenční příručka souboru Lockfile vysvětluje, proč se běžné zpracování může po spuštění s omezeným rozsahem znovu vrátit ke změně zdroje. Část Stávající překlady popisuje, jak převzít překlady bez nahrazení všech existujících hodnot.
Vyberte další krok #
Pomocí postupu pro první soubor zopakujte spuštění starší verze v malém rozsahu. Části Konfigurace a Formáty uvádějí, co nainstalovaná generace čte a zapisuje.
Při další práci vám část Jazyky ukáže, jak přidat cílový jazyk; Řízení klíčů rozlišuje běžné úpravy od hodnot spravovaných lidmi; Opětovný překlad vymezuje rozsah cílené aktualizace. Části Monorepozitáře a Paralelní zpracování se věnují odpovědnosti za obsah a propustnosti, aniž by předpokládaly, že více pracovních procesů odstraní limity poskytovatele.