Konfigurace CLI v0
Nastavte skupiny souborů, jazykové cesty a překladové backendy pro starší CLI, aniž byste směšovali různé generace.
lingo.dev@0.138.10 načítá i18n.json z pracovního adresáře. Skupina souborů určuje parser a slouží k vyhledávání souborů; nastavení jazyků určuje zdrojový jazyk a cílové jazyky. Jde o samostatnou konfiguraci s jinými pravidly než u současného .lingo/config.json.
Definujte jazyky a skupiny souborů #
{
"$schema": "https://lingo.dev/schema/i18n.json",
"version": "1.15",
"locale": { "source": "en", "targets": ["es", "fr"] },
"buckets": {
"json": {
"include": ["locales/[locale].json"],
"lockedKeys": ["brand/name"],
"ignoredKeys": ["internal/*"],
"preservedKeys": ["legal/terms"]
},
"markdown": {
"include": ["docs/[locale]/*.md"],
"exclude": ["docs/[locale]/drafts/*.md"]
}
}
}Cesty se vyhodnocují relativně k umístění konfigurace. Parser se vybírá podle klíče skupiny souborů, nikoli podle přípony souboru. Pokud formát ukládá více jazyků do jednoho souboru, nahlédněte do tabulky formátů a výstupů pro starší verzi.
Pole version zaznamenává generaci schématu. Migrace staršího schématu může tento soubor aktualizovat, aniž byste přešli na současné CLI. Původní konfiguraci si ponechte a zkontrolujte všechny vygenerované změny.
Pravidla pro cesty nastavujte uvážlivě #
[locale] se nahradí kódem zdrojového nebo cílového jazyka. Oddělovač nastavený pro konkrétní cestu umožňuje používat názvy souborů s podtržítky:
{
"include": [
"standard/[locale].json",
{ "path": "legacy/[locale].json", "delimiter": "_" }
]
}Pro en-US používá druhá cesta legacy/en_US.json. Zápis jazyka v názvu souboru je nezávislý na normalizovaných hodnotách jazyků odesílaných backendu.
Rekurzivní vyhledávání ** je dostupné od 0.135.0; ve starších verzích je nutné cesty zadat výslovně. Rekurzivní vyhledávání ve výchozím nastavení vynechává node_modules, .git, dist, build, .next a .turbo. Z vyhledávání vylučte i další generované adresářové stromy.
Nastavte chování klíčů #
Starší nastavení klíčů používají lomítka k oddělení úrovní při průchodu strukturou a zástupné znaky k vyhledávání shod. modules/ai.translation vybírá klíč s doslovnými tečkami v názvu uvnitř modules. Uzamčení kopíruje zdrojové hodnoty, ignorování vynechává výstup a zachování nejprve doplní chybějící hodnoty ze zdroje a poté je ponechá výhradně k ruční správě. injectLocale vybírá výstupní klíče pro kód cílového jazyka.
Přesné dopady jednotlivých nastavení najdete v části Nastavení klíčů. Překladová instrukce nechrání strukturu a zástupný text ve zdrojovém jazyce musí před použitím přeložit člověk.
Vyberte lokalizační engine nebo přímého poskytovatele #
Při použití přihlašovacího údaje Lingo.dev vybírá engineId glosář, pravidla, styl komunikace a modely lokalizačního engine. Výběr raději zadávejte výslovně. Pokud jej vynecháte, rozhodují pravidla backendu, nikoli označení konkrétní stabilní konfigurace; současná služba může vyžadovat ID nebo vybrat nejstarší aktivní lokalizační engine, ke kterému má daný klíč přístup.
Přímí poskytovatelé používají ID poskytovatele, model a prompt. Tento historický formát není doporučením k použití uvedeného modelu ani potvrzením jeho současné dostupnosti:
{
"provider": {
"id": "openai",
"model": "gpt-4o-mini",
"prompt": "Translate the provided text from {source} to {target}."
}
}V promptu se {source} a {target} nahrazují kódy jazyků. Nespoléhejte na to, že provider.baseUrl přesměruje požadavky run z lingo.dev@0.138.10. Implementace pro OpenAI předává baseUrl, zatímco závislost poskytovatele s pevně nastavenou verzí čte baseURL, takže se tato konfigurační hodnota ignoruje. Závislost místo toho podporuje OPENAI_BASE_URL; před odesláním obsahu nebo přihlašovacích údajů ověřte, že směřují na zamýšlené místo. Implementace pro Ollama také ignoruje provider.baseUrl a vytváří poskytovatele s výchozím nastavením. Jeho služba musí být dostupná z prostředí, ve kterém úloha běží; vzdálené prostředí nemůže použít adresu localhost vašeho notebooku.
| Backend | Přihlašovací údaj |
|---|---|
| Lingo.dev | LINGO_API_KEY |
| OpenAI | OPENAI_API_KEY |
| Anthropic | ANTHROPIC_API_KEY |
GOOGLE_API_KEY | |
| Mistral | MISTRAL_API_KEY |
| OpenRouter | OPENROUTER_API_KEY |
| Lokální Ollama | Lokální nastavení nepoužívá klíč API poskytovatele. |
LINGO_API_URL mění cílovou adresu služby Lingo.dev; kompatibilitu a důvěryhodnost je přesto nutné ověřit. Přihlašovací údaje neukládejte do konfigurace ani do logů. Po změně backendu nebo vyhledávání souborů zopakujte malý zkušební běh s prvním souborem. Změna modelu nebo promptu nemění otisky zdrojového obsahu. Pokud tedy chcete aktualizovat stávající text, je nutné provést cílenou aktualizaci.