lingo init
Vytvořte konfiguraci lokalizace s výslovně zadanými cestami ke zdroji, cíli a katalogům.
lingo init zapíše nastavení lokalizace do .lingo/config.json. Příkaz použijte při prvním nastavení zdrojového jazyka, seznamu cílových jazyků a vzorů souborů v projektu. Zdrojové soubory, přihlašovací údaje a propojení s lokalizačním engine se řeší samostatně: inicializace tyto prostředky nevytváří ani nepřekládá.
lingo init --source en --targets de,fr --files 'locales/en.json,docs/en/**/*.md' --yesOtevřete vygenerovaný soubor a ověřte, že vybírá jen požadovaný zdrojový obsah. Poté v případě potřeby vytvořte příslušné soubory, přihlaste se a před vzdáleným překladem spusťte link.
Volby #
| Volba | Výchozí hodnota nebo účinek |
|---|---|
--source <locale> | en při přijetí výchozích hodnot. |
--targets <list> | Jazyky oddělené čárkami; de,fr,es s --yes. |
--files <list> | Vzory oddělené čárkami: locales/<source>.json s --yes, například locales/en.json. |
--messages-path <path> | Nastaví katalog pro React i18n.messagesPath; výchozí hodnota je locales. |
--types-path <path> | Nastaví deklaraci i18n.typesPath; výchozí hodnota je lingo.d.ts. |
--force | Nahradí stávající nastavení lokalizace. |
--no-agents-md | Přeskočí blok Lingo.dev v AGENTS.md a CLAUDE.md. |
--yes, -y | Použije zadané nebo výchozí hodnoty bez dotazování. |
Bez --yes vás CLI vyzve k zadání chybějících voleb. Položky seznamů se oddělují čárkami a mezerami. Vzor obsahující mezeru proto přidejte úpravou .lingo/config.json. Duplicitní cílové jazyky a jazyk přesně shodný se zdrojovým jazykem se odstraní. Pokud je výsledný seznam cílových jazyků prázdný, bude odmítnut. Vzory uzavřete do uvozovek, aby je shell nerozbalil dříve, než je obdrží CLI.
Inicializace také zapíše blok Lingo.dev do projektového souboru AGENTS.md, a pokud tento soubor chybí, vytvoří ho. Blok zapíše i do existujícího souboru CLAUDE.md, pokud neimportuje soubor AGENTS.md, do kterého se blok vloží místo toho. Blok dává programovacím agentům pokyn, aby před zahájením lokalizace spustili npx @lingo.dev/cli agent-guide. Text mimo značky ohraničující blok zůstane zachován a při dalším spuštění se nahradí pouze text mezi nimi.
Opětovná inicializace stávajícího projektu #
Bez vynucení se stávající konfigurace lokalizace zachová a inicializace místo jejího přepsání skončí chybou. Při vynucení příkaz znovu sestaví files[] podle vzorů. Pokročilé volby položek, jako jsou vyloučení, výslovně zadané formáty, výstupní šablony a nastavení klíčů, se ztratí. Před vynucením si je proto uložte, nebo v případě menší změny upravte stávající konfiguraci.
Ostatní sekce na nejvyšší úrovni včetně propojení s organizací a lokalizačním engine zůstanou zachovány. Výchozí cesty ke katalogům se do uložené konfigurace nezapisují; vynucené spuštění s návratem k výchozím hodnotám tak může odstranit dříve nastavené vlastní hodnoty i18n. Změna cest ke katalogům automaticky nezmění vzory souborů s překlady.
Postup pro první soubor vás provede od konfigurace přes úvodní doplnění překladů až po stažení cílových souborů. Referenční informace k pokročilým položkám souborů najdete v části Konfigurace.