Konfiguration für CLI v0
Konfiguriere ältere Buckets, Sprachpfade und Übersetzungs-Backends, ohne die Generationen zu vermischen.
lingo.dev@0.138.10 liest i18n.json aus dem Arbeitsverzeichnis. Ein Bucket legt den Parser fest und ermittelt die Dateien; die Spracheinstellungen bestimmen die Ausgangs- und Zielsprachen. Dafür gelten andere Konfigurationsvorgaben als für das aktuelle .lingo/config.json.
Sprachen und Buckets deklarieren #
{
"$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"]
}
}
}Pfade werden relativ zur Konfiguration aufgelöst. Der Bucket-Schlüssel bestimmt den Parser, nicht die Dateiendung. Sieh in der älteren Format-/Ausgabematrix nach, wenn ein Format mehrere Sprachen in einer Datei speichert.
Das Feld version gibt die Schemageneration an. Eine Migration des älteren Schemas kann diese Datei aktualisieren, ohne auf die aktuelle CLI umzustellen. Bewahre die bisherige Konfiguration auf und sieh dir jede automatisch erzeugte Änderung an.
Pfade gezielt abgleichen #
[locale] wird durch den Code der Ausgangs- oder Zielsprache ersetzt. Mit einem pfadspezifischen Trennzeichen lassen sich Dateinamen mit Unterstrichen verwenden:
{
"include": [
"standard/[locale].json",
{ "path": "legacy/[locale].json", "delimiter": "_" }
]
}Für en-US verwendet der zweite Pfad legacy/en_US.json. Die Schreibweise im Dateinamen ist unabhängig von den normalisierten Sprachwerten, die an das Backend gesendet werden.
Die rekursive Dateisuche mit ** ist ab 0.135.0 verfügbar; ältere Versionen benötigen explizite Pfadangaben. Standardmäßig schließt die rekursive Suche node_modules, .git, dist, build, .next und .turbo aus. Füge Ausschlüsse für weitere automatisch erzeugte Verzeichnisbäume hinzu.
Verhalten für Schlüssel festlegen #
Die älteren Einstellungen zur Schlüsselsteuerung verwenden durch Schrägstriche getrennte Pfade und Platzhaltermuster. modules/ai.translation wählt innerhalb von modules den wörtlichen Schlüssel mit Punkten aus. Beim Sperren werden die Ausgangswerte kopiert, beim Ignorieren entfällt die Ausgabe. Beim Beibehalten werden fehlende Werte zunächst aus der Ausgangssprache übernommen; danach bleibt ihre Bearbeitung in menschlicher Hand. injectLocale wählt die Ausgabeschlüssel für den Code der Zielsprache aus.
Die genauen Auswirkungen findest du unter Schlüsselsteuerung. Eine Übersetzungsanweisung schützt nicht die Struktur, und ein Platzhalter in der Ausgangssprache muss vor der Verwendung weiterhin von einem Menschen übersetzt werden.
Eine Lokalisierungs-Engine oder einen direkten Anbieter auswählen #
Mit Lingo.dev-Zugangsdaten wählt engineId das Glossar, die Regeln, die Markenstimme und die Modelle einer Lokalisierungs-Engine aus. Wähle die Engine möglichst explizit aus. Ohne diese Angabe greift die Backend-Richtlinie, statt eine feste Konfiguration festzulegen; der aktuelle Dienst kann eine ID verlangen oder die älteste aktivierte Lokalisierungs-Engine auswählen, auf die der Schlüssel Zugriff hat.
Direkte Anbieter verwenden eine Anbieter-ID, ein Modell und einen Prompt. Diese ältere Konfigurationsform ist nicht als Empfehlung zu verstehen, die von der fortdauernden Verfügbarkeit des genannten Modells ausgeht:
{
"provider": {
"id": "openai",
"model": "gpt-4o-mini",
"prompt": "Translate the provided text from {source} to {target}."
}
}Der Prompt ersetzt {source} und {target} durch Sprachcodes. Verlasse dich nicht darauf, dass provider.baseUrl die run-Anfragen von lingo.dev@0.138.10 umleitet. Der OpenAI-Codepfad übergibt baseUrl, während die auf eine feste Version festgelegte Anbieterabhängigkeit baseURL ausliest. Daher wird dieser Konfigurationswert ignoriert. Die Abhängigkeit unterstützt stattdessen OPENAI_BASE_URL; vergewissere dich vor dem Senden von Inhalten oder Zugangsdaten, dass das Ziel korrekt ist. Der Ollama-Codepfad ignoriert ebenfalls provider.baseUrl und erstellt den Anbieter mit Standardwerten. Der zugehörige Dienst muss vom Runner aus erreichbar sein; ein entfernter Runner kann die localhost-Adresse eines Laptops nicht verwenden.
| Backend | Zugangsdaten |
|---|---|
| Lingo.dev | LINGO_API_KEY |
| OpenAI | OPENAI_API_KEY |
| Anthropic | ANTHROPIC_API_KEY |
GOOGLE_API_KEY | |
| Mistral | MISTRAL_API_KEY |
| OpenRouter | OPENROUTER_API_KEY |
| Lokales Ollama | Bei lokaler Einrichtung ist kein API-Schlüssel des Anbieters erforderlich. |
LINGO_API_URL ändert die Zieladresse des Lingo.dev-Dienstes; Kompatibilität und Vertrauenswürdigkeit müssen weiterhin sichergestellt werden. Speichere keine Zugangsdaten in der Konfiguration oder in Protokollen. Wiederhole nach Änderungen am Backend oder an der Dateisuche einen kleinen Durchlauf mit einer ersten Datei. Änderungen am Modell oder Prompt verändern die Fingerabdrücke der Ausgangstexte nicht. Bestehende Texte benötigen daher eine gezielte Aktualisierung, wenn du sie neu übersetzen lassen möchtest.