Übersetzungen für die Messung erfassen

Wähle eine unterstützte Quelle und bewahre Text, Revisionen und Kontext auf, die für eine Messung benötigt werden.

Für Messungen kannst du Übersetzungen nutzen, die dein Team bereits erstellt. Pflege die akzeptierten Texte weiterhin im Repository oder Übersetzungsmanagementsystem und entscheide, wie du sie für eine Kontrolle bereitstellst.

Die sinnvolle Einheit ist eine eindeutig identifizierbare Version. Ändert sich eine Nachricht nach der Auswertung, bezieht sich die frühere Antwort weiterhin auf den damaligen Wortlaut. Wenn du Ausgangs- und Zielrevisionen zusammen aufbewahrst, kann dein Team auf die Belege zurückgreifen, statt sie aus den aktuellen Inhalten rekonstruieren zu müssen.

Wähle die Quelle für deinen Workflow #

AusgangspunktSo misst du
Crowdin-AktivitätVerbinde Crowdin, konfiguriere eine Ereignismessung und sieh dir das daraus entstandene Radar-Ereignis und die Antwort an. Für die Radar-Ansichten benötigst du Radar-Zugriff.
GitHub-CommitsVerbinde die GitHub App und konfiguriere die Ausgangs- und Zielpfade. Änderungen an unterstützten Lokalisierungsschlüsseln im Standard-Branch werden zu Ereignissen.
Zendesk-HilfecenterVerbinde Zendesk. Änderungen an veröffentlichten Artikeln werden zu Ausgangstext- oder Übersetzungsereignissen in den jeweiligen Sprachen.
Lokale ÜbersetzungsdateienVerwende lingo score mit einem konfigurierten Scorer und Modell. Die Ergebnisse werden lokal gespeichert, außerhalb des Radar-Ereignisverlaufs.
Lingo.dev-ÜbersetzungenJede abgeschlossene Lokalisierung ist bereits ein Ereignis. Unter Prüfung von Lingo.dev-Übersetzungen erfährst du, wie du Engines, Sprachen und eine Stichprobe auswählst.

Wenn du eine andere Quelle nutzen möchtest, kontaktiere Lingo.dev, um die Ereigniserfassung einzurichten, bevor du die Übermittlung automatisierst.

GitHub- und Zendesk-Aktivitäten erfassen #

Installiere für GitHub die App für das gewünschte Repository und verbinde sie mit der Lingo.dev-Organisation. Nimm .lingo/config.json mit Angaben zur Ausgangssprache, den Zielsprachen und den Dateimustern für die Ausgangsdateien in einen Commit auf. Anhand dieser Pfade lässt sich zuordnen, welche Änderungen zum Ausgangstext und welche zu den Übersetzungen gehören. Sieh dir ein Ereignis an, nachdem ein Commit im Standard-Branch einen konfigurierten Lokalisierungsschlüssel geändert hat. Ein Commit kann Ereignisse für mehrere Schlüssel und Sprachen erzeugen.

Die GitHub-Erfassung liest JSON-, JSONC- und YAML-Dateien, YAML-Dateien mit einem Wurzelschlüssel, Android-Ressourcen, Apple .strings, Flutter-ARB-, PHP- und TypeScript-Dateien. Unter Repository-Änderungen erfährst du, wie Änderungen zu Ereignissen werden.

Autorisiere für Zendesk die Hilfecenter-Verbindung und aktiviere die zugehörigen Sprachen. Radar erfasst Aktivitäten an veröffentlichten Artikeln nach Sprache. Öffne das Ereignis und gleiche Artikelidentität, Sprache und Text mit Zendesk ab. Die Erfassung von Aktivitäten löst allein noch keinen Übersetzungs-Sync aus und veröffentlicht keinen neuen Zielartikel.

Bei beiden Verbindungen bleiben akzeptierte Übersetzungen in ihrem ursprünglichen System. Eine Messung untersucht die erfassten Ereignisse, ohne selbst zum Veröffentlichungsschritt zu werden.

Anbieterverlauf vor der Messung importieren #

Wähle den benötigten Anbieterverlauf:

  • GitHub: Importiert bis zu 5.000 der neuesten Commits im Standard-Branch des Repositorys. Jeder Commit wird mit der in der jeweiligen Revision gespeicherten Konfiguration .lingo/config.json gelesen. Commits aus der Zeit, bevor diese Konfiguration vorhanden war, erzeugen keine Ereignisse.
  • Zendesk: Importiert die aktuell veröffentlichten Versionen bestehender Artikel, Abschnitte und Kategorien in jeder Sprache, jeweils mit dem Datum ihrer letzten Aktualisierung. Frühere Revisionen und Entwurfsversionen werden nicht erfasst.

Neue GitHub- und Zendesk-Verbindungen starten automatisch einen Verlaufsimport. Den Fortschritt kannst du im Tab Einstellungen der Verbindung verfolgen. So startest du später einen Import oder wiederholst ihn:

  1. Wähle in Studio unter Verbunden das Repository oder Hilfecenter aus und öffne den zugehörigen Tab Einstellungen.
  2. Wähle unter Commit-Verlauf für GitHub oder Hilfecenter-Verlauf für Zendesk die Option Verlauf importieren.
  3. Verfolge den Importfortschritt. Die Anzeige zählt die Einträge des Anbieters, die zur Erfassung vorgemerkt sind.
  4. Warte, bis die Ereignisse, die du messen möchtest, unter Radar → Protokolle sichtbar sind. Sieh dir dann ihre Datumsangaben, Sprachen und Texte an.

Bei einer Messung auf Basis von Anbieterereignissen bietet der Tab Nachträgliche Verarbeitung auch die Option Ereignisse importieren für verbundene GitHub-Repositorys und Zendesk-Hilfecenter. Der importierte Verlauf wird erfasst, ohne Messungen auszuführen. Sobald die gewünschten Ereignisse sichtbar sind, aktiviere die Messung und starte eine historische Auswertung für den entsprechenden Zeitraum.

Wenn nach der nachträglichen Verarbeitung weitere importierte Ereignisse erscheinen, wiederhole die Verarbeitung mit aktivierter Option Nur noch nicht gemessene Ereignisse. Schlägt der Import fehl, sieh dir seinen Fortschritt an und starte über denselben Tab Einstellungen einen erneuten Versuch. Sieh dir die nachträgliche Verarbeitung der Messung und ihre Ergebnisse getrennt vom Import an.

Vergleichsgrundlage bewahren #

Bewahre die ID des Quellsystems, die Inhalts-ID, die Zielsprache und die Zielrevision zusammen auf. Ergänze für eine Bedeutungskontrolle die zugehörige Ausgangsrevision. Bewahre für eine Messung von Bearbeitungen den Entwurf auf, aus dem der bearbeitete Zieltext entstanden ist.

In deiner eigenen Dokumentation kennzeichnet zum Beispiel die Kombination aus delivery.promise, Sprache fr und Revision 42 einen bestimmten Katalogeintrag. Revision 43 kann das darin enthaltene Versprechen ändern.

Halte fest, woher die Übersetzung stammt, wenn der Workflow diese Information liefert: von einem Menschen, einem Modell, einem Anbieter maschineller Übersetzung oder aus der Wiederverwendung eines Translation-Memory-Eintrags. Kennzeichne eine unbekannte Herkunft weiterhin als unbekannt. Wer eine Übersetzung beim Anbieter freigegeben hat, ist nicht unbedingt die Person oder das Modell, von der oder dem sie stammt.

Belege für die gewählte Fragestellung bereitstellen #

Das Kriterium bestimmt, was du erfassen musst. Für eine Rechtschreibkontrolle reicht der Zieltext allein aus. Eine Bedeutungskontrolle benötigt das zugehörige Paar aus Ausgangs- und Zieltext sowie Kontext, um Mehrdeutigkeiten aufzulösen. Eine Terminologiekontrolle benötigt den jeweils geltenden Begriff und die Grenzen seines Einsatzbereichs. Eine Platzhalterkontrolle benötigt die erwarteten verbindlichen Vorgaben für Platzhalter, die Editierdistanz dagegen das tatsächliche Paar aus Entwurf und Zieltext.

Fehlt einer Übersetzung die Ausgangsrevision, belasse sie bei einer Bedeutungskontrolle unter den noch nicht beurteilten Fällen. Beschaffe den Ausgangstext, bevor du die Übersetzung beurteilst.

Ein erfasstes Ereignis verifizieren #

  1. Konfiguriere die ausgewählte Messung, bevor du Testaktivitäten in der verbundenen Quelle erzeugst.
  2. Suche das zugehörige Ereignis. Vergleiche Sprache, Text, Herkunft und verfügbaren Entwurf mit deiner eigenen Dokumentation.
  3. Öffne die Antwort der Messung und lies das Kriterium neben dem Text. Sieh nach, ob eine Antwort oder N/A zurückgegeben wurde oder ob der Vorgang nicht abgeschlossen werden konnte.
  4. Bewahre die Kennungen von Ereignis und Messung zusammen mit den ausgewerteten Revisionen auf. Nimm akzeptierte Korrekturen in dem System vor, das den Text verwaltet.

Sieh dir bei einer lokalen Bewertung stattdessen das gespeicherte Ergebnis zusammen mit den Eingabedateien und der Scorer-Konfiguration an. Auf diesem Weg entsteht kein Radar-Ereignis.

Halte bei einem wiederkehrenden Workflow fest, was ausgewählt, erfasst und gemessen wurde. Übersetzungen aus deiner Pipeline messen behandelt die Erfassung und Wiederherstellung, einschließlich erneuter Versuche und geänderter Revisionen.