Dokumentation

Übersetzen Sie Ihr Projekt

Richten Sie Übersetzungen für ein Projekt ein, halten Sie sie über die Qualitätskontrolle auf dem neuesten Stand und erfahren Sie ihre Kosten.

Coroid übersetzt Ihr Produkt mit demselben Engine, das es für seine eigenen dreizehn Sprachen nutzt. Ihre Kataloge bleiben als Dateien in Ihrem Repository. Jede Änderung daran kommt als normaler Task und pull request herein – nur neue, geänderte oder fehlerhafte Zeichenfolgen werden an ein Modell gesendet.

Die Übersetzungen befinden sich unter Qualitätskontrolle → Übersetzungen. Die Liste zeigt jedes Projekt, ob Übersetzungen konfiguriert sind und den letzten Scan an. Öffnen Sie ein Projekt, um dessen Arbeitsbereich zu nutzen.

Storefront
Konfiguriert · Quelle: en · 4 Zielsprachen
ÜbersichtSetupKonfigurationMitwirkendeVorschlägeAutomatisierungen
Letzte PrüfungMängel einsehenLauf einsehen
SpracheFehlendVeraltet
de02
fr140
ja141
ar140
  • ÜbersetzungenTask-QA und Pull Requests · nur geänderte ZeichenfolgenVeröffentlicht
  • ÜbersetzungsauditGeplant · jede Katalog- und SprachseiteEntwurf

Qualitätskontrolle → Übersetzungen für ein Projekt: die neueste Übersetzungsprüfung pro Sprache sowie die Steuerungen für Übersetzungen und Übersetzungsaudits. Beispieldaten.

Was Ihr Repository benötigt

Coroid liest Kataloge in diesen Formaten:

FormatVerwenden Sie es für
ICU JSONNachrichtendateien mit ICU-Pluralformen und -Auswahlen
i18next JSONi18next- und react-i18next-Kataloge, einschließlich Plural-Suffixe
Vue i18n JSONvue-i18n-Nachrichten, einschließlich verknüpfter Nachrichten und Pipe-Pluralformen
Rails YAMLconfig/locales/*.yml, mit %{name} Interpolation und Plural-Schlüsseln
gettext PO.po Dateien und einer .pot Vorlage, mit Plural-Forms pro Sprache
Markdown und MDXDokumentationsseiten unter einem Sprachordner (docs/en/…): Text, Bildbeschreibungen und ausgewählte Frontmatter-Felder; Code und Markup bleiben unverändert.
BenutzerdefiniertJedes andere Format über einen kleinen Adapter-Befehl in Ihrem Repository.

Sie benötigen noch keine Übersetzungen. Falls Ihr Projekt kein i18n hat, kann Coroid dieses einführen.

Einrichten

Das Setup Reiter führt durch drei Schritte.

  1. Erkennen. Coroid bereitet einen Entdeckungs-Task vor. Es führt die festgelegte Übersetzungs-Engine gegen Ihr Repository aus und protokolliert den Stack, die Kataloge, welche Sprache die Quelle ist und alles, worüber es unsicher ist.
  2. Auswählen. Wählen Sie Bestehendes i18n übernehmen aus, um Ihr Framework und die Kataloge beizubehalten und Coroid's Prüfungen sowie Delta-Engine hinzuzufügen. Wählen Sie i18n einführen aus, damit Coroid Ihr Framework verdrahtet, repräsentative Zeichenfolgen extrahiert und Locale-Routing, Fallbacks sowie Unterstützung für von rechts nach links orientierte Schriften hinzufügt.
  3. Erstellen. Coroid erstellt den Setup-Task mit einer Spezifikation und Akzeptanzkriterien. Das Ergebnis ist ein pull request, das Sie wie jeder andere prüfen.
Storefront
Noch nicht konfiguriert · Einrichtung läuft
ÜbersichtSetupKonfigurationMitwirkendeVorschlägeAutomatisierungen
  1. Erkennen
  2. 2Auswählen
  3. 3Erstellen
Erkannt: Next.js mit next-intl · 3 JSON-Kataloge · Quelle: en
Bestehende i18n-Lösung übernehmen

Ihr aktuelles Framework und die Kataloge bleiben erhalten; zusätzlich werden die Übersetzungsprüfungen und der Delta-Engine von Coroid hinzugefügt.

i18n einführen

Ihr Framework anbinden, repräsentative Zeichenfolgen extrahieren und anschließend Sprachrouting, Fallbacks sowie RTL-Verhalten einrichten.

Quellsprache
en
Zielsprachen
de, fr, ja, ar
Fortfahren

Die Registerkarte „Setup“ nach der Erkennung: bestehendes i18n übernehmen oder einführen, inklusive Quell- und Zielsprachen. Beispieldaten.

Das Setup ist fertig, sobald dieser pull request in den Standardzweig Coroid synchronisiert wird. Bis dahin geht der Arbeitsbereich davon aus, dass nichts anderes vorhanden ist.

Die Repository-Datei

Beim Setup wird .coroid/i18n.jsongeschrieben. Sie beschreibt Ihr Repository, liegt also in Ihrem Repository und ändert sich über Pull Requests:

{
  "version": 1,
  "cli": { "version": "1.7.0", "sha256": "…" },
  "sourceLocale": "en",
  "targetLocales": ["de", "fr", "ja", "ar"],
  "catalogs": [
    {
      "id": "ui",
      "format": "i18next-json",
      "source": "messages/{locale}.json"
    }
  ],
  "localeTier": { "ja": "escalation" }
}
  • cli fixiert die exakte Engine-Version und deren Prüfsumme. Coroid lädt diese Version herunter und verifiziert sie vor jedem Lauf, sodass ein Update Ihre Ausgabe nicht unerwartet verändert.
  • sourceLocale kann jede Sprache sein. Eine schwedische Quelle, die ins Englische und Deutsche übersetzt wird, funktioniert auf dieselbe Weise.
  • localeTier fordert die stärkere Übersetzungsroute für eine Locale an. Sie wählen ein Tier aus – niemals ein Modell.

Die Datei kann auch ein Glossar, geschützte Begriffe, Produktkontext und Anweisungen pro Locale enthalten.

Um sie zu ändern, bearbeiten Sie den Vorschlag auf dem Konfiguration Reiter und wählen Sie Änderung vorschlagen. Coroid öffnet einen Task, der genau diese Datei anwendet und alle betroffenen Übersetzungen repariert.

Derselbe Reiter enthält die Einstellungen, die zu Coroid statt zu Ihrem Repository gehören: Welche Seiten den Vorschlagsauswähler öffnen dürfen, ob Vorschläge standardmäßig überprüft werden und das Ausgabenlimit für Übersetzungen des Projekts.

Jede Änderung prüfen

Übersetzungen werden durch zwei Qualitätskontrollen Teil der Verifizierung. Fügen Sie sie vom Übersicht Reiter hinzu.

  • Übersetzungen läuft im Task-QA und bei Pull Requests. Es prüft nur die Zeichenfolgen, die von einer Änderung betroffen sind.
  • Übersetzungs-Audit läuft nach einem Zeitplan. Es prüft jeden Katalog und jede Locale und kann einen Browser-Test der Locale-Seiten einschließen, um Layouts von rechts nach links, Überlauf und nicht übersetzten Text auf der Seite zu überprüfen.

Ein neuer Kontrollpunkt bereitet einen Richtlinienentwurf vor. Überprüfen Sie ihn und veröffentlichen Sie ihn unter Qualitätsrichtlinien um ihn zu aktivieren.

Jedes Problem wird zu einem Befund mit einem Issue-Code:

CodeBedeutungBlockiert standardmäßig
missingDie Zeichenfolge hat keine ÜbersetzungJa
invalid_syntaxDie Übersetzung lässt sich nicht parsen – beispielsweise fehlerhafte ICU-StrukturJa
placeholder_mismatchPlatzhalter weichen von der Quelle abJa
plural_categoriesEine für die Region erforderliche Pluralform fehlt.Ja
staleDer Quelltext hat sich nach der Übersetzung der Zeichenfolge geändert.Nein

Sie wählen in den Einstellungen des Steuerelements aus, welche Codes blockiert werden sollen. Das Glossar sowie die Regeln zu Länge und verbotenen Begriffen geben bei der Konfiguration Ihrer Datei ihre jeweiligen Codes an.

Qualitätskontrolle
Ergebnisse der neuesten Ausführungen, gefiltert nach dem Translations-Check.
RichtlinienMängel4Läufe
  • missingui · checkout.total · frNicht übersetzt
  • staleui · nav.deals · deQuelle wurde seit der Übersetzung geändert
  • placeholder_mismatchui · cart.items · jaPlatzhalter weichen vom Quelltext ab
  • plural_categoriesui · cart.count · arFür diese Sprache fehlen Pluralformen

Qualitätsmängel aus der Übersetzungsprüfung – jeweils ein Fehlercode pro Fund. Beispieldaten.

Wenn ein Übersetzungsfehler eine Aufgabe blockiert, behebt der Entwickler-Agent dies stets auf dieselbe Weise: Er öffnet eine Übersetzungssitzung für die Aufgabe und führt den Engine auf den geänderten Zeichenfolgen aus. Er bearbeitet Kataloge im Zielformat niemals manuell.

Das Translator-Modell

Übersetzung hat in AI-Profilen ihre eigene Rolle, Übersetzer, neben Architekt, Entwickler, QA und Rezensent. Standardmäßig wird Hy-MT2 als Übersetzungsmodell verwendet, wobei GPT-6 Luna als Fallback zum Einsatz kommt, sofern die Richtlinien Ihres Unternehmens dies zulassen. Die Zuordnung kann wie bei jeder anderen Rolle in einem AI-Profil geändert werden.

Der Engine gruppiert Zeichenfolgen außerdem nach Größe, überprüft jede Antwort auf Platzhalter und Pluralregeln und wiederholt den Vorgang oder leitet die betreffende Zeichenfolge weiter, falls ein Fehler auftritt.

Kosten

Übersetzungen sind in jedem Plan verfügbar. Übersetzungsanfragen werden über das Übersetzungs-Gateway von Coroid geleitet und als Modellnutzung für Ihr Unternehmen abgerechnet – genauso wie der Betrieb der Agenten. Einrichtungsaufgaben zählen wie jede andere Aufgabe zur verfügbaren Agenten-Stunden-Zahl Ihres Plans.

Mit der Standard-Route des Übersetzers kosten Übersetzungen etwa zwei Cent pro 1.000 Zeichenfolgen und Sprache. Die Übersetzung eines 2.000 Zeichenfolgen umfassenden Katalogs in zehn Sprachen kostete laut unseren Messungen etwa 0,33 $.

  • Nur Änderungen verursachen Kosten. Der Engine speichert einen Cache, der über den Quelltext indiziert ist; unveränderte Zeichenfolgen werden daher nie erneut gesendet.
  • Jede Aufgabe hat eine Übersetzungsgrenze. Eine Sitzung endet bei Erreichen des Ausgabegrenzbetrags der Aufgabe – standardmäßig 1 $. Ein Projekt kann einen niedrigeren Grenzwert festlegen unter Konfiguration → Zugriff und Ausgaben.
  • Prüfungen initiieren keine Modellaufrufe. Das Steuerelement „Übersetzungen“ sowie die Überprüfung lesen Ihre Kataloge aus; sie übersetzen jedoch nicht.

Übersetzen außerhalb von Coroid

Der Engine ist ein Befehlszeilen-Tool, coroid-i18n. Ihr eigenes CI-System kann dieselbe festgelegte Version mit seinem eigenen OpenRouter-Schlüssel ausführen. Innerhalb von Coroid nutzen Aufgaben stets das Übersetzungs-Gateway, sodass Ausgaben und Grenzwerte an einem Ort bleiben.