Integrationen

Binden Sie Repositories und CMS für Übersetzungen an, führen Sie Lokalisierung in CI aus, sammeln Sie Nachweise aus Crowdin oder untersuchen Sie Jira-Feedback.

Nutzen Sie Lingo.dev mit den Tools, in denen Ihr Team Inhalte schreibt, übersetzt und deren Prüfung durchführt. Jede Verbindung erfüllt eine eigene Aufgabe: Einige übertragen übersetzte Inhalte zurück ins Quellsystem, andere sammeln Nachweise oder helfen dabei, Feedback zu untersuchen.

Inhalte direkt im bestehenden System übersetzen #

Diese nativen Verbindungen lesen ausgewählte Quellinhalte, übersetzen sie mit einer Lokalisierungs-Engine und schreiben die Ergebnisse zurück. Dafür nutzen sie die Zugriffsrechte, die Sie beim jeweiligen Anbieter erteilen.

VerbindungWas die Verarbeitung auslöstWohin die Übersetzungen zurückgeschrieben werden
GitHubKonfigurierte Repository-Ereignisse oder ein Übersetzungsbefehl mit festgelegtem UmfangEin Übersetzungs-Pull Request für Änderungen am Standard-Branch oder Commits auf dem Branch eines geeigneten Pull Requests.
PayloadManuelle Synchronisierung oder Benachrichtigungen des Plugins über Änderungen an den QuellinhaltenLokalisierte Felder in denselben Sammlungen und Globalen, jeweils für die ausgewählten Zielsprachen.
WordPressManuelle Synchronisierung oder vom Plugin gemeldete Speichervorgänge bei veröffentlichten InhaltenDie verknüpfte Polylang- oder WPML-Übersetzung jedes Beitrags in den ausgewählten Sprachen.
Zendesk Help CenterManuelle SynchronisierungSprachversionen der ausgewählten Kategorien, Abschnitte und Artikel.

Die Anbieterkonfiguration bestimmt den Umfang des Zugriffs. Wählen Sie für GitHub Repositorys und Muster für Quelldateien aus, für Payload Sammlungen und Globale mit lokalisierten Feldern und für WordPress Beitragstypen. Wählen Sie für Zendesk Kategorien, Abschnitte und Artikel jeweils separat aus: Wenn Sie eine Kategorie auswählen, werden ihre untergeordneten Elemente nicht mit ausgewählt.

Auch das Verhalten bei der Veröffentlichung hängt vom Anbieter ab. Der Veröffentlichungsmodus von Payload schreibt erst dann in ein veröffentlichtes Dokument mit unveröffentlichten Änderungen, wenn diese Änderungen veröffentlicht oder rückgängig gemacht wurden – denn beim Veröffentlichen der Übersetzung würden auch diese Änderungen veröffentlicht. Das Schreiben eines Entwurfs in Zendesk kann eine bereits veröffentlichte Sprachversion entfernen, bis sie erneut veröffentlicht wird. Lies vor dem ersten Schreibvorgang den Abschnitt zur Veröffentlichung des jeweiligen Anbieters, besonders wenn bereits Übersetzungen vorhanden sind.

Übersetzungen in Ihrer Pipeline ausführen #

GitHub Actions, GitLab CI, Bitbucket Pipelines und Buildkite führen die CLI auf deinem eigenen Runner aus. Die Anleitungen sehen zunächst herunterladbare Artefakte oder einen einzigen vertrauenswürdigen Branch vor. So kannst du dir das Ergebnis ansehen, bevor du den Schreibzugriff auf das Repository ausweitest. Sobald .lingo/lock.json committed ist, lässt lingo check einen Pull Request oder Merge Request fehlschlagen, wenn sich eine Quelle seit ihrer letzten Übersetzung geändert hat oder eine Zieldatei fehlt. Dafür ist kein API-Schlüssel nötig.

Ihre Pipeline übernimmt die Zeitplanung, die Verwaltung geheimer Konfigurationswerte, die Aufbewahrung der Ausgaben und die Erstellung von Commits oder Pull Requests. Der Lingo.dev-API-Schlüssel berechtigt zur Übersetzung; die Zugangsdaten des Anbieters berechtigen zu Schreibvorgängen im Repository. Übersetzungen in CI automatisieren erklärt, wie Sie Quellrevisionen, fertige Ausgaben und Anwendungstests zusammenführen.

Übersetzungen messen oder Feedback untersuchen #

Crowdin sendet unterstützte Aktivitäten auf Ebene einzelner Zeichenfolgen an Radar. Damit können Sie in Crowdin erstellte Übersetzungen untersuchen, ohne den Workflow für ihre Erstellung oder Prüfung zu verlagern. Konfigurieren Sie eine Messung für die Frage, die Sie beantworten möchten, und sehen Sie sich anschließend den erfassten Text und das zugehörige Ergebnis an. Diese Verbindung synchronisiert korrigierte Übersetzungen nicht zurück zu Crowdin.

Jira setzt bei einem gemeldeten Problem an. Mit dem Label lingo fordern Sie den Triage-Workflow auf, das Problem zu untersuchen und Änderungen am Glossar, an Regeln oder an der Markenstimme vorzuschlagen. Die zuständigen Personen übernehmen oder verwerfen jeden Vorschlag und entscheiden anschließend, ob betroffene verbundene Inhalte erneut übersetzt werden sollen. Die Jira-Triage übersetzt den Ticketinhalt nicht als Lokalisierungsprojekt.

Erst den ersten Durchlauf abschließen, dann den Umfang erweitern #

Jede Anbieterseite führt Sie durch einen ersten Durchlauf mit kleinem Umfang: von der Autorisierung und Konfiguration über die Sichtung der Ausgabe bis zur Wiederherstellung. Nutzen Sie diesen Durchlauf, um festzustellen, was die Verbindung liest und verändert. Ob eine Verbindung verfügbar ist, kann von den Berechtigungen Ihrer Organisation und dem Zugriff auf Funktionen abhängen. Zugangsdaten eines Anbieters allein gewähren keinen Zugriff auf eine Lokalisierungs-Engine.

Wenn Sie eine Verbindung außer Betrieb nehmen, stoppen Sie neue Auslöser und kümmern Sie sich separat um die Zugangsdaten des Anbieters. Das Trennen macht bereits übertragene Inhalte, veröffentlichte Kommentare oder aufgezeichnete Messungen nicht rückgängig. Der Abschnitt zur Wiederherstellung beim jeweiligen Anbieter erklärt, welcher Zustand erhalten bleibt und was eine erneute Verbindung bewirkt.

Für einen von Ihrer Anwendung gesteuerten Workflow finden Sie unter DevTools Informationen zu den API-, CLI- und JavaScript-Schnittstellen.