Entwicklertools
Übersetze Dateien, rufe die API von deinem Server aus auf und rendere mehrsprachige Anwendungen mit JavaScript-Paketen.
Lokalisierung verbindet zwei Arten von Code: Code, der Übersetzungen erstellt, und Code, der sie nutzt. Ein Server kann übersetzte Inhalte anfordern, sobald sich ein Datensatz ändert. Ein Build kann übersetzte Dateien zusammenführen. Eine React-Komponente kann einen vorhandenen Katalog auslesen, ohne dafür eine Übersetzungsanfrage zu stellen.
Starte mit dem Bereich, den du gerade implementierst. Jeder Abschnitt führt dich durch eine vollständige erste Aufgabe und beschreibt anschließend die Schnittstellenspezifikationen für die weitere Arbeit.
API #
Nutze die API, wenn die Inhalte bereits auf deinem Server liegen und dieser entscheiden soll, wann eine Übersetzung angefordert, wo sie gespeichert und wann sie verwendet wird. Übermittle JSON-Inhalte oder hochgeladene Dateien als Übersetzungsauftrag, starte ihn und rufe die fertigen Ergebnisse für jede Zielsprache ab. Die Engine steuert die Phasen für Übersetzung und Prüfung.
Die Anleitung Deine erste Anfrage stellen zeigt, wie du eine kleine Datenmenge sendest und die übersetzten Daten lokal speicherst. Sie erläutert die Zugangsdaten, die Auswahl der Lokalisierungs-Engine, die Antwortfelder und die nötigen Kontrollen, bevor du den Datenspeicher deiner Anwendung anbindest.
CLI #
Nutze die CLI, wenn deine Inhalte in Dateien vorliegen. Konfiguriere die Quellpfade und Zielsprachen, übermittle die ausgewählten Aufgaben und lade die Zieldateien in dein Projekt. Die CLI hält die Ausgangsstände der Quelldateien fest, damit spätere Durchläufe Änderungen verarbeiten können, statt jede Datei als neu zu behandeln.
Die Anleitung Deine erste Datei übersetzen führt dich durch Installation, Authentifizierung, Konfiguration und Abruf. Mit derselben CLI kannst du auch explizite React-Nachrichten extrahieren und in Katalogen ablegen; die Extraktion erfolgt lokal und löst keine Übersetzungsanfragen aus.
JavaScript #
Die JavaScript-Pakete bieten Server-Clients, die Darstellung von React-Nachrichten und sprachbasiertes Routing. Wähle einen Client für Übersetzungsanfragen oder eine Darstellungsbibliothek für Nachrichten, die deiner Anwendung bereits vorliegen. Für die Darstellung im Browser brauchst du keinen Übersetzungs-API-Schlüssel.
Die React-Dokumentation enthält ein lokales Beispiel für deine erste Nachricht sowie Informationen zum Laden von Katalogen, zu grammatischen Varianten, Rich Text und zur frameworkspezifischen Integration. Die Sprachauswahl über die URL und die übersetzten Texte sind getrennte Aufgaben. Deshalb erläutern die Routing-Referenzen, wie du die ausgewählte Sprache und die geladenen Nachrichten aufeinander abstimmst.
Ein bestehendes Projekt einbinden #
Unter Formate erfährst du, was der jeweilige Handler übersetzt und rekonstruiert. Sieh dir auch die Formatliste des aufrufenden Tools an: Ein Handler, der für eine Serverintegration verfügbar ist, ist nicht unbedingt als CLI-Dateiformat konfiguriert.
Für Projekte, die i18n.json oder LingoDotDevEngine verwenden, gibt es versionierte Referenzen für CLI v0 und SDK v0. Behalte die installierte Version bei, während du die Migration planst; Konfiguration, gespeicherter Zustand und Rückgabewerte können sich zwischen den Generationen ändern.
Nutze MCP für einen Assistenten, der mit lokalen Dateien oder der Kontokonfiguration arbeitet. Für Übersetzungen, die an ein Repository, CMS oder Hilfecenter angebunden sind, nutze Integrationen. Jede Verbindung legt fest, wie die Verarbeitung startet, welche Berechtigungen sie nutzt und wohin die Ergebnisse zurückfließen.