Rozsahy překladu

Vybírejte soubory a stabilní klíče a přitom rozlišujte mezi přírůstkovými aktualizacemi, pokrytím cílových jazyků a záměrným obnovením překladů.

Změna v lokalizaci se může týkat souboru, jazyka nebo sady zpráv. CLI pro každý z těchto rozsahů používá jiný způsob výběru: konfigurace projektu určuje soubory a cílové jazyky; poziční vzory zužují výběr souborů a mění plán zpracování; --key vybírá zprávy podle stabilního klíče.

Rozsah souborů mění plán zpracování #

sh
lingo push 'locales/en.json' --wait

Vzor zužuje výběr nakonfigurovaných zdrojových souborů. U formátu s oddělenými soubory tento příkaz vytvoří chybějící cílové soubory a stávající ponechá beze změny, i když se zdroj změnil. Pokud z úlohy vynechá některé nakonfigurované jazyky, zachová stávající výchozí stav zdroje, aby pozdější běžný příkaz push mohl tyto úpravy zpracovat. Pokud výchozí stav ještě neexistuje, může ho inicializovat.

Pro běžné úpravy zdroje použijte samotný příkaz lingo push --wait. Chcete-li záměrně nahradit celý soubor ve formátu s oddělenými soubory, zadejte rozsah pozičním argumentem spolu s --force. Počítejte s tím, že vynucené nahrazení zahodí stávající kontext cílového překladu. Katalogy XCStrings mohou i nadále využívat vložené překlady; viz aktualizace katalogů. Cíle se vždy určují podle targetLocales; příkaz push nemá přepínač --locale ani --target-locale.

Obnovení podle stabilních klíčů #

sh
lingo push 'locales/en.json' --key 'checkout.title' --key 'checkout.submit' --wait

Pro více výběrů opakujte --key. Klíč je cesta zapsaná tečkovou nebo závorkovou notací, například checkout.title či items[0].title. Výběr objektu zahrnuje všechny řetězce pod ním. Proto auth.login zahrnuje auth.login.title, ale nevybere auth.login_url. * zastupuje jeden celý segment a [] každou položku pole; částečné zástupné vzory, například auth.log*, se odmítají. Vzor začínající na $. nebo $[ se předá jako dotaz JSONPath. Vzory se zástupnými znaky uzavírejte do uvozovek.

Fungují i vzory zapsané pro dřívější verzi CLI pomocí /. Vzor obsahující / se dělí pouze podle / a každý název se zpracovává jako celek: auth/login vybírá stejné klíče jako auth.login a common/error.message vybírá klíč error.message pod common. Názvy s procentním kódováním, například legal/Terms%20of%20use, se dekódují; vzor bez / je cesta v tečkové notaci a nedekóduje se. Samostatný kódovaný název proto zapište jako JSONPath, například $['Terms of use']. Protože se takto zpracovává každý vzor s /, klíč s názvem obsahujícím / vyžaduje zápis JSONPath, například $.routes['/about'].title. V tomto zápisu * zastupuje jeden celý název a koncové *, jako v auth/*, vybírá hodnoty přímo pod auth, ale nikoli objekty nebo pole vnořené na této úrovni, stejně jako v dřívější verzi CLI. Koncové /** zahrnuje vše pod názvem, který mu předchází: auth/** je totéž co auth a auth/*/** zahrnuje také objekty a pole pod auth, které auth/* vynechává. Číslo, například items/0, vybírá položku pole nebo klíč objektu "0" podle toho, co dokument obsahuje. Zástupné vzory uvnitř názvu, ** jinde než na konci, závorky a prázdné názvy, například a//b, se odmítají.

FormátyRozsah podle klíčů
JSON/JSONC, PHP, TypeScript, soubory properties pro JavuZnovu generuje vybrané řetězce včetně těch, jejichž zdrojové hodnoty se nezměnily.
YAML / YAML s kořenovým klíčemVybírá stabilní klíče, ale u vybraných řetězců, které se nezměnily, může znovu využít stávající překlady.
gettext, ARB, Apple strings, XCStrings, CSV, Android, XLIFFNení podporováno; --key zastaví příkaz push s chybou.
Markdown, MDX, Markdoc, HTML, OpenAPI YAML, SubRip, prostý text, Apple stringsdictBez stabilních klíčů; přeskočí se s upozorněním.

Obnovení podle klíčů vyžaduje existující cílové soubory. Chybějící jazyky a formáty bez stabilních klíčů se přeskočí s upozorněním, místo aby se pro ně vytvářely počáteční překlady. Příkaz backfill doplňuje chybějící běžné soubory, nikoli chybějící obsah uvnitř stávajících souborů. Přidání --force nemění plánování podle klíčů ani nebrání opětovnému využití překladů v YAML.

Obnovení podle klíčů ponechává výchozí stav celého zdroje beze změny, ať už výsledky stáhne push --wait, nebo samostatný příkaz pull. Dosud nezpracované běžné úpravy zdroje se proto zpracují při příštím běžném příkazu push.

Obnovení po změně pokynů #

Úprava glosáře nebo pravidel lokalizačního engine nemění bajtový obsah zdrojových souborů. Běžný příkaz push proto nemusí nic provést. U formátů JSON, JSONC, TypeScript a PHP vyberte dotčené stabilní klíče. U YAML proveďte přesnou opravu přímo v cílovém souboru, nebo uložte schválené cílové soubory a znovu je vygenerujte pomocí --force s rozsahem vymezeným na celé soubory a bez --key. Zkontrolujte celý výsledný soubor, protože toto nahrazení může změnit i sousední zprávy. Nastavení klíčů určují, které zdrojové nebo cílové hodnoty se při rekonstrukci zachovají; neurčují, co se má zpracovat.

U rozsáhlé změny zvolte tak malý rozsah, abyste mohli výsledek zkontrolovat a v případě potřeby obnovit původní stav. Před odesláním pak vytvořte odhad. Při odhadu se nahrají všechny potřebné soubory a naplánuje se zpracování, ale překladová úloha se nevytvoří.

Opětovný překlad jednoho jazyka #

U projektu se samostatným souborem pro každý jazyk odstraňte cílové soubory daného jazyka a doplňte chybějící soubory příkazem backfill. Nejprve dokončete čekající aktualizace zdroje a uložte schválené překlady. Příkaz purge s filtrem zachová výchozí stavy zdroje i záznamy v Lockfile pro ostatní jazyky.

Pro nakonfigurovaný zdroj na cestě locales/en.json zobrazte náhled odstranění francouzských cílových souborů:

sh
lingo purge --locale fr --file locales/en.json

Zkontrolujte vypsané cesty. Pokud jde o zamýšlené cílové soubory, potvrďte odstranění a vytvořte chybějící překlady:

sh
lingo purge --locale fr --file locales/en.json --yes
lingo push --backfill-missing --wait

U konfigurace se zástupnými vzory, například locales/en/*.json, předejte v obou příkazech purge konkrétní cesty ke zdrojům pomocí opakovaných voleb --file. Příkaz purge zástupné vzory sám nerozvíjí. Zahrňte každý zdroj, jehož francouzský cílový soubor chcete znovu vygenerovat, a před spuštěním příkazu backfill ověřte, že nechybí žádné jiné cílové soubory: backfill vytváří všechny chybějící nakonfigurované cílové soubory.

Po dokončení zkontrolujte francouzský výstup a zahrňte ho do commitu spolu s aktualizovaným Lockfile. Stávající cílové soubory pro ostatní jazyky zůstanou beze změny. Pravidla výběru najdete v části Purge. Tento postup se nevztahuje na katalogy XCStrings, kde zdroj a všechny cílové jazyky sdílejí jeden soubor.