Eine Datei mit CLI v0 übersetzen
Reproduziere einen kleinen Kataloglauf für eine ältere Version mit einer festgelegten Paketversion und sieh dir die Ausgabe und das Lockfile an.
Nutze dieses Verfahren für ein installiertes i18n.json-Projekt oder eine isolierte Testumgebung für eine ältere Version. Es ist auf lingo.dev@0.138.10 ausgelegt, dessen Manifest Node.js 18 oder neuer voraussetzt. Kontrolliere zuerst node --version und dein installiertes lingo --version. Für neue Projekte solltest du den aktuellen Schnellstart verwenden.
Das dokumentierte Paket verwenden #
Behalte bei einem bestehenden Projekt die festgelegte Version der Abhängigkeit bei. Wähle für eine separate Testumgebung den Paketmanager, den du sonst verwendest:
npm install --save-dev lingo.dev@0.138.10
pnpm add --save-dev lingo.dev@0.138.10
yarn add --dev lingo.dev@0.138.10
bun add --dev lingo.dev@0.138.10Führe nur einen Installationsbefehl aus. Rufe die lokale ausführbare Datei über npm exec -- lingo, pnpm exec lingo, yarn lingo oder bun run lingo auf. In den folgenden Beispielen steht dafür kurz lingo. Mit einer lokalen Installation in der festgelegten Version und dem Aufruf über die ausführbare Datei des Paketmanagers bist du unter Windows außerdem nicht auf die Befehlsauflösung anhand des Paketnamens angewiesen.
Katalog und Konfiguration erstellen #
Führe lingo init in dem Verzeichnis aus, in dem das Projekt liegen soll. Der Befehl erstellt i18n.json. Behalte eine vorhandene Datei bei, statt sie neu zu initialisieren. Erstelle locales/en.json:
{
"welcome": "Welcome back",
"button.save": "Save changes"
}Verwende den passenden JSON-Bucket:
{
"$schema": "https://lingo.dev/schema/i18n.json",
"version": "1.15",
"locale": { "source": "en", "targets": ["es"] },
"buckets": {
"json": { "include": ["locales/[locale].json"] }
}
}version bezeichnet die Version des Konfigurationsschemas, nicht die Paketversion. Dieses Muster liest englische Inhalte aus locales/en.json und schreibt spanische Inhalte nach locales/es.json.
Übersetzungs-Backend bereitstellen #
Stelle für Lingo.dev LINGO_API_KEY über den Mechanismus deiner Shell für geheime Zugangsdaten bereit. Ergänze die Konfiguration um das vorgesehene engineId und stelle sicher, dass der Schlüssel Übersetzungen über diese Lokalisierungs-Engine ermöglicht. Ohne diese Angabe greift die implizite Auswahl des Backends; die aktuelle Dienstrichtlinie kann jedoch eine explizite ID verlangen.
Die v0-Konfiguration für die direkte Nutzung eines Anbieters ist eine separate Option. Sie verwendet anbieterspezifische Zugangsdaten oder einen erreichbaren Ollama-Dienst. Die zugehörige Konfigurationsreferenz erläutert die Felder. Diese gehören nicht in die JSON-Konfiguration der aktuellen CLI.
Ausführen und Ausgabe ansehen #
lingo runSieh dir in locales/es.json sowohl die Schlüssel als auch die tatsächlichen Übersetzungen an. Stelle sicher, dass die Speichermeldung weiterhin die vorgesehene Aktion nennt. Lade bei der Anbindung an eine Anwendung den Zielkatalog über den Katalog-Lader, den die Anwendung tatsächlich verwendet. Halte die akzeptierte Ausgabe, die Konfiguration und i18n.lock gemeinsam in einem Commit fest.
Ein normaler Lauf mit unverändertem Quelltext sollte die vorhandenen Zielwerte beibehalten. Änderungen am Quelltext oder eine erzwungene Ausführung können sie ersetzen. Läufe, die auf bestimmte Zielsprachen oder Schlüssel beschränkt sind, aktualisieren eine bestehende Ausgangsbasis des Quelltexts nicht. Der eingefrorene Modus kann zudem ein fehlendes Lockfile initialisieren. Lies Festlegung der Ausgangsbasis, bevor du aus einer Ausgabe mit begrenztem Umfang schließt, dass das gesamte Projekt aktualisiert ist.
Während der Entwicklung beobachtet lingo run --watch Änderungen am Quelltext, bis du es mit Ctrl+C stoppst. Sieh dir vor dem Erweitern der Testumgebung die Übernahme vorhandener Übersetzungen und die manuelle Kontrolle über Zielübersetzungen an.