So funktioniert es

Verfolge eine Inhaltsänderung von der Quelle über gespeicherte Übersetzungsvorgaben bis zu einem Ergebnis, das du nutzen und kontrollieren kannst.

Wenn du Inhalte schreibst und überarbeitest, entscheidest du, was deine Leserschaft verstehen soll, wo mehr Erklärung nötig ist und welche Argumente überzeugen. Eine Übersetzung sollte diese Bedeutung und die dahinterstehende Überzeugungsabsicht in einer anderen Sprache genauso präzise vermitteln. Lingo.dev übersetzt deine Inhalte mit Sprachmodellen und gespeicherten Vorgaben zu deinem Produkt, deiner Terminologie und deinem Sprachstil.

Du stellst den Ausgangsinhalt und die benötigten Sprachen bereit und wählst die Lokalisierungs-Engine für die Übersetzung aus. Bei einem API-Aufruf wird sie mit engineId angegeben; die CLI oder eine Integration verwendet die Lokalisierungs-Engine aus ihrer Konfiguration. Diese Auswahl bestimmt, welche Modelle und gemeinsamen Vorgaben für die Anfrage verfügbar sind. Die übersetzten Inhalte kommen über das Tool zurück, das sie angefordert hat. Qualitätsmessungen und die menschliche Prüfung folgen den von dir konfigurierten Abläufen.

Starte mit dem Inhalt und seiner Zielsprache #

Der Inhalt, den du bereitstellst, ist der Ausgangsinhalt. Jede übersetzte Version ist ein Zielinhalt. Ausgangsinhalte können aus einer Datei, aus strukturierten Daten einer Anwendung oder aus einem verbundenen Inhaltssystem stammen. Die angeforderten Ausgangs- und Zielsprachen legen fest, welche Sprachen beteiligt sind.

Die Angabe der Sprache legt fest, welche Sprache und bei Bedarf welche Region oder Schrift gemeint ist. Wähle die gewünschte Zielgruppe ausdrücklich: Eine Anfrage für pt-BR legt brasilianisches Portugiesisch fest, statt die Region offenzulassen. Die Ausgangs- und Zielsprachen helfen Lingo.dev außerdem, die passenden Übersetzungsvorgaben auszuwählen. Sprachzuordnung erklärt die Regeln dafür.

Neben der Sprache zählt auch die Struktur des Inhalts. Eine Anwendung verwendet Textschlüssel, um Texte zu finden, und Variablen, um Werte einzufügen. Ein Dokument enthält Überschriften, Links und Formatierungen. Bei einem API-Aufruf werden strukturierte Daten direkt übergeben; die CLI und Format-Handler extrahieren übersetzbare Texte aus Dateien und setzen deren Zielversionen wieder zusammen. Jeder dieser Wege muss Inhalte zurückgeben, die das empfangende System weiterhin verwenden kann.

Bewahre beim Speichern von Übersetzungen oder für spätere Untersuchungen die zugehörige Version des Ausgangsinhalts zusammen mit der Ausgabe auf. Sobald die Autorin oder der Autor die Bedeutung ändert, vermittelt eine für die vorherige Version korrekte Übersetzung möglicherweise nicht mehr die beabsichtigte Aussage.

Speichere das Wissen, das spätere Anfragen brauchen #

Ein Sprachmodell kann mit Sprache umgehen. Es kennt aber nicht automatisch die Terminologie deines Produkts, die vereinbarten Anforderungen deines Teams oder die Art, wie dein Unternehmen seine Leserschaft anspricht. Eine Lokalisierungs-Engine speichert die Modellauswahl und Verknüpfungen zu wiederverwendbaren Vorgaben. So kann jede Anfrage dieses Wissen nutzen, ohne dass du alles erneut senden musst.

Verschiedene Arten von Vorgaben beantworten unterschiedliche Fragen:

  • Ein Glossar hält Begriffe, ihre beabsichtigte Bedeutung und bevorzugte Formulierungen fest – ebenso wie Namen, die unübersetzt bleiben sollen. Es hilft dem Modell, ein Produktkonzept von anderen Verwendungen desselben Wortes zu unterscheiden.
  • Ein Regelsatz enthält Übersetzungsanweisungen. Er kann wiederkehrende Anforderungen festhalten, die eine Begriffsliste nicht abbilden kann. Dazu gehören auch Bedeutungsunterschiede, die in der Übersetzung erhalten bleiben müssen.
  • Eine Markenstimme beschreibt, wie das Unternehmen seine Leserschaft anspricht, einschließlich Tonfall und Formalitätsgrad.

Glossare, Regelsätze und Markenstimmen gehören zu deiner Organisation und können mehreren Lokalisierungs-Engines hinzugefügt werden. Zusammengehörige Workflows können dieselbe Terminologie nutzen und bei Bedarf unterschiedliche Modelle oder Markenstimmen verwenden. Änderungen an einer gemeinsam genutzten Ressource können sich auf jede Lokalisierungs-Engine auswirken, die sie verwendet. Sieh dir deshalb ihre Verknüpfungen an, wenn du Vorgaben änderst.

Für jede Anfrage wählt Lingo.dev aus der gewählten Lokalisierungs-Engine relevante Glossarbegriffe, passende Anweisungen, eine Variante der Markenstimme und mögliche Modelle aus. Ein JSON-Dokument kann außerdem format.options.context zur Beschreibung der Zielgruppe oder des Zwecks sowie format.options.hints für einzelne Schlüssel bereitstellen. So bleibt gemeinsames Wissen in der Lokalisierungs-Engine gespeichert, während du die Besonderheiten der zu übersetzenden Inhalte erläutern kannst. Übersetzungskontext beschreibt diese Möglichkeiten im Detail.

Standardwerte im Erstellungsformular #

Im Erstellungsformular der Web-App sind die folgenden Standardwerte voreingestellt. Du kannst die Modelle ändern und vorhandene Vorgaben auswählen, bevor du die Erstellung abschließt.

EinstellungStandardwert im Formular
ModelleEin empfohlenes primäres Modell und ein Ersatzmodell decken alle Sprachpaare ab. Du kannst die Modelle ändern oder ein bestimmtes Sprachpaar separat konfigurieren.
Glossare, Regelsätze und MarkenstimmeStandardmäßig sind keine Verknüpfungen ausgewählt. Wähle bei der Erstellung vorhandene Ressourcen aus oder füge sie später hinzu.
PipelineNur Übersetzung. Optionale Schritte zur Umformulierung und menschlichen Prüfung sind zunächst deaktiviert.
Punktevergabe für Glossar und Anweisungen; VorschlägeDie automatische Punktevergabe, das Erstellen von Vorschlägen und deren automatische Anwendung sind zunächst deaktiviert.

Bestehende Lokalisierungs-Engines können andere Einstellungen gespeichert haben. Sieh dir die Engine an, die für deinen Aufruf verwendet wird, statt davon auszugehen, dass ihre Konfiguration noch den Standardwerten entspricht. Eine Lokalisierungs-Engine erstellen und konfigurieren erläutert die Modellauswahl und Verknüpfungen.

Erzeuge den Zielinhalt und gib ihn an die aufrufende Anwendung zurück #

Das ausgewählte Sprachmodell erhält den Ausgangsinhalt und den passenden Kontext. Kann das zuerst konfigurierte Modell die Anfrage nicht abschließen, kann die Lokalisierungs-Engine ihr Ersatzmodell verwenden. Das ermöglicht einen weiteren Versuch; dabei werden nicht beide Übersetzungen verglichen, um diejenige mit dem höchsten Qualitätswert auszuwählen.

Mit der API erstellst und startest du einen Übersetzungsauftrag und lädst anschließend die fertigen Zielinhalte herunter. Die JSON-Ausgabe behält die Textschlüssel des Dokuments bei. Deine Anwendung entscheidet, wo sie die Ausgabe speichert oder verwendet. Mit der CLI übernehmen Push und Pull diesen Datei-Workflow für dich. Jede Integration schreibt Ergebnisse auf ihre eigene Weise zurück, etwa indem sie einen Pull Request für die Übersetzung öffnet. Integrationen erklärt, was jede Verbindung liest und schreibt.

Die zurückgegebene Struktur verbindet die Übersetzung mit deinen weiteren Arbeitsschritten. Stelle sicher, dass die Anwendung den Katalog laden, seine Variablen ersetzen oder die Links und Formatierungen des Dokuments darstellen kann. Diese Kontrollen zeigen, dass das empfangende System die Ausgabe verwenden kann. Um ihre sprachliche Qualität zu messen, brauchst du andere Nachweise.

Kontrolliere das Ergebnis im Workflow, der es verwendet #

Wähle Messungen danach aus, worauf es bei deinen Inhalten ankommt. Um festzustellen, ob die Bedeutung erhalten geblieben ist, brauchst du den Ausgangsinhalt und seine Übersetzung sowie genügend Kontext, um die Absicht der Autorin oder des Autors zu verstehen. Eine Rechtschreibkontrolle kommt allein mit dem Zielinhalt aus. Unterschiedliche Fragen erfordern unterschiedliche Nachweise. Das Ergebnis ist dann nützlich, wenn du sehen kannst, was kontrolliert wurde, und die Textstelle ansehen kannst, auf der die Antwort beruht.

Die Pipeline der Engine kann eine menschliche Prüfung vorsehen, bevor der Auftrag seine endgültige Ausgabe erzeugt. Informationen zu Abdeckung, Weiterleitung und Verhalten bei Zeitüberschreitungen findest du unter Prüfungsrichtlinie: Ein fertiger Zielinhalt kann die Prüfung übersprungen haben oder nach einer Zeitüberschreitung weiterverarbeitet worden sein. Unabhängige Qualitätsmessungen laufen separat. Eine abgeschlossene Übersetzung bedeutet daher weder, dass ein fertiger Qualitätsbericht vorliegt, noch, dass eine Person sie freigegeben hat.

Messungen können auch Übersetzungen untersuchen, die außerhalb von Lingo.dev erstellt wurden. Du kannst dein bestehendes System zur Texterzeugung beibehalten und unter Messen erfahren, wie du dessen Ausgabe mit den unterstützten Verfahren untersuchen kannst. Die Messung beantwortet eine klar definierte Frage zum bereitgestellten Text. Dein Team entscheidet, was das Ergebnis für dessen Verwendung bedeutet.

Wenn eine Prüfung ein wiederkehrendes Terminologieproblem aufdeckt, korrigiere die aktuelle Übersetzung und ziehe für künftige Arbeiten eine separate Änderung am Glossar oder an den Anweisungen in Betracht. Eine Aktualisierung gemeinsamer Vorgaben schreibt nicht alle früheren Übersetzungen um. Vorschläge beschreibt, wie mit vorgeschlagenen Änderungen an Vorgaben umgegangen wird.

Um Inhalte aus einer Anwendung zu übersetzen, stelle deine erste API-Anfrage. Die Anleitung führt dich mit einem kleinen Datensatz durch die Einrichtung, die Übersetzung und das Ansehen einer gespeicherten Zieldatei. Liegt dein Ausgangsinhalt bereits in Dateien vor, führt dich stattdessen der CLI-Schnellstart auf diesem Weg bis zum Abruf.