Ein Projekt internationalisieren

Der Internationalisierungs-Assistent macht ein Projekt mehrsprachig. Er liest Ihr Repository aus, startet alle Schritte mit den gefundenen Daten und endet mit einer Aufgabe, die eine pull request öffnet. Sie müssen nie einen Sprachcode eingeben oder JSON bearbeiten; ändern Sie nur das, was Sie wollen – im Repository wird bis zum Mergen nichts verändert.

Inhaber und Administratoren führen den Assistenten aus. Starten Sie ihn über Globalisierung → Internationalisierung: wählen Sie Ein Projekt internationalisieren, oder Den Assistenten starten in der Zeile des Projekts. Bei einem bereits mehrsprachigen Projekt Einstellungen → Sprachen ändern in dessen Arbeitsbereich öffnet denselben Assistenten, um Änderungen vorzuschlagen.

Die Schritte#

1. Scannen#

Coroid liest den Standardzweig ohne Ausführung des Codes aus. Er sucht nach Katalogen und deren Sprachen, den verwendeten Frameworks sowie Texten, die noch direkt im Code stehen, aufgeschlüsselt nach Datei.

• Kataloge gefunden. Der Assistent behält sie bei: Coroid fügt seine Prüfungen hinzu und übersetzt das Fehlende. Das nennt man Übernehmen.
• Noch keine Kataloge vorhanden. Coroid überträgt den Text aus Ihrem Code in Kataloge und ersetzt ihn durch Lookup-Aufrufe. Das nennt man Einführen.
• Bereits eingerichtet. Das Projekt verfügt bereits über eine Coroid-Konfiguration, und der Assistent schlägt Änderungen daran vor.

2. Quellsprache#

Die Sprache, in der das Produkt geschrieben ist; alle anderen Sprachen werden daraus übersetzt. Der Assistent erkennt sie aus Ihren Katalogen oder schließt sie aus dem Text im Code. Jede Sprache kann die Quellsprache sein: Ein schwedisches Produkt, das ins Englische und Deutsche übersetzt wird, funktioniert auf dieselbe Weise.

3. Sprachen#

Wählen Sie die Sprachen einzeln aus oder fügen Sie gleich einen ganzen Markt hinzu: Am häufigsten gesprochen, Europa, Nordische Länder, Ostasien, Die Amerikas oder Rechts nach links. Jede Sprache zeigt ihren eigenen Namen, ob sie rechts nach links geschrieben wird und wie viele Pluralformen sie benötigt.

Regionale Varianten können abgeleitet werden statt übersetzt zu werden. Britisches Englisch wird aus amerikanischem Englisch mit britischer Rechtschreibung abgeleitet, Schweizer Deutsch aus Hochdeutsch mit schweizerischer Rechtschreibung – dadurch entstehen keine Kosten und sie bleiben mit ihrem Ursprung synchron.

4. Zeichenketten#

Beim Übernehmen wählen Sie die Kataloge aus, die Coroid weiterhin übersetzen soll; ihre Schlüssel und Struktur bleiben unverändert. Beim Einführen wählen Sie die Dateien aus, deren Text Coroid in Kataloge überträgt; ausgelassene Dateien bleiben unverändert.

5. Stil und Begriffe#

Alles optional und in jeder Sprache anwendbar:

• Formell oder informell. Für Sprachen, die den Leser formell oder informell ansprechen, wie zum Beispiel Deutsch Sie und du. Standardmäßig folgt jede Variante dem Tonfall des Quelltextes.
• Begriffe werden unverändert übernommen. Produkt-, Marken- und Funktionstitel, die in jeder Sprache gleich bleiben.
• Über das Produkt. Einige Sätze über das Produkt und seine Nutzer, die jeder Übersetzung helfen, die richtigen Wörter zu wählen.

6. Kultur#

Jeder Markt schreibt Datum, Zahlen und Preise auf seine eigene Weise. Wählen Sie aus, wie der Code für den Leser formatiert wird: Der Assistent schlägt den vom Framework gefundenen Formatter vor, etwa von next-intl oder react-intl, oder beschreiben Sie Ihren eigenen. Anschließend wählen Sie die Währung aus, in der jeder Markt zahlt; jede beginnt mit der jeweiligen regionalen Währung. Jeder Markt zeigt ein Beispieldatum und eine Zahl, den Wochentag, an dem die Woche beginnt, und die Papiergröße. Die Agenten von Coroid folgen beiden Einstellungen; sehen Sie sich dazu Kultur.

7. Qualität und Automatisierung#

Standardmäßig aktiviert und später einzeln anpassbar:

• Übersetzungen bei jeder Änderung prüfen. Die Globalisierungsprüfung sendet bei fehlenden oder fehlerhaften Zeichenketten eine Änderung zurück oder weist darauf hin, dass Text im Code statt im Katalog hinzugefügt wurde.
• Zeichenketten übersetzen, die außerhalb von Coroid gemergt wurden. Wenn jemand neuen Text ohne Coroid mergt, wird eine Aufgabe zur Übersetzung erstellt.
• Korrekturen jede Nacht übernehmen. Genehmigte Vorschläge von Mitwirkenden kommen jede Nacht als eine pull request zusammen.
• Eingeladene Personen dürfen Wortvorschläge machen. Eingeladene Muttersprachler können Übersetzungen auf Ihrer Seite korrigieren. Sehen Sie sich dazu Übersetzungen mit Vorschlägen pflegen.

Die Konfigurationsdatei enthält die letzte Version. Coroid aktiviert die anderen, sobald ein Inhaber oder Administrator nach dem Mergen der pull request die Globalisierung öffnet – und zwar nur einmal: Wenn Sie später eine Einstellung deaktivieren, bleibt sie ausgeschaltet.

8. Rezension#

Ein Überblick über das Projekt, die Aufgabe, die Ausgangssprache, die Zielsprachen – einschließlich abgeleiteter Varianten –, das Übersetzungsvolumen, die wortgetreu beibehaltenen Begriffe, den Formatter sowie die Währungen und was nach dem Merge passiert. Die Übersetzung wird wie andere Agentenarbeit als Modellnutzung abgerechnet und pro Aufgabe begrenzt.

Wählen Sie Internationalisieren. Coroid erstellt eine Aufgabe mit einer Spezifikation und Akzeptanzkriterien und startet sie umgehend.

Was die Aufgabe bewirkt#

• Übernehmen schreibt die Konfigurationsdatei exakt so, wie der Assistent sie zusammengestellt hat, und übersetzt anschließend alle fehlenden Zeichenfolgen.
• Vorstellung verbindet Ihr Framework, verschiebt den Text der ausgewählten Dateien in Kataloge, fügt Sprachrouting, Fallbacks und Unterstützung für Rechts-zu-Links-Schriften hinzu und übersetzt anschließend.
• Ändern schreibt die neue Konfiguration und korrigiert die durch die Änderung betroffenen Übersetzungen.

Die Aufgabe endet in einem pull request. Sobald sie in den Standardbranch gemergt wird, erscheinen alle Sprachen in Lokalisierung, und World readiness analysiert den Code auf Hinweise auf einzelnsprachige Annahmen.

Formate#

Coroid liest Kataloge in folgenden Formaten:

Die Konfigurationsdatei#

Der Assistent schreibt .coroid/i18n.json. Sie beschreibt Ihr Repository, liegt daher im Repository und wird über Pull Requests geändert:

{
  "version": 1,
  "cli": { "version": "1.16.0", "sha256": "…" },
  "sourceLocale": "en",
  "targetLocales": ["de", "fr", "ja", "ar"],
  "derivedLocales": [
    { "locale": "en-GB", "from": "en", "rules": "en-gb-spelling" }
  ],
  "catalogs": [
    {
      "id": "ui",
      "format": "i18next-json",
      "source": "messages/{locale}.json"
    }
  ],
  "protectedTerms": ["Storefront"],
  "localeInstructions": {
    "de": "Address the reader informally (du)."
  },
  "world": {
    "formatter": "useFormatter from next-intl",
    "currencies": { "de": "EUR", "fr": "EUR", "ja": "JPY", "ar": "SAR" }
  }
}

• cli fixiert die exakte Engine-Version und ihren Prüfsummenwert. Coroid lädt diese Version vor jedem Lauf herunter und verifiziert sie, sodass ein Update Ihre Ausgabe nicht unerwartet verändert.
• derivedLocales listet die durch Regeln erzeugten regionalen Varianten auf.
• protectedTerms und localeInstructions speichern Ihre Auswahl unter Stil und Begriffe, und world Ihre Auswahl unter Kultur. Der Globalisierungs-Check listet die übrigen world.

Die Datei kann außerdem ein Glossar, Produktkontext, sprachspezifische Übersetzungspfade sowie die Vorschlagsbindung für Mitwirkende enthalten.

Einstellungen → Konfigurationsdatei im Arbeitsbereich zeigt die exakte Datei im Standardbranch an. Um sie dort zu ändern, bearbeiten Sie den Vorschlag und wählen Sie Änderung vorschlagen: Coroid öffnet eine Aufgabe, die genau diese Datei anwendet und alle durch die Änderung betroffenen Übersetzungen korrigiert. Für Sprachen und Stil ist der Assistent der einfachere Weg.

Verwandt#

• Globalisierung
• World readiness und Kultur
• Lokalisierungs-Arbeitsbereich
• Übersetzungen mit Vorschlägen pflegen
• Spezifikationen