Ein Projekt internationalisieren

Der Internationalisierungs-Assistent macht ein Projekt mehrsprachig. Er liest Ihr Repository aus, beginnt jede Schrittfolge mit den gefundenen Daten und endet mit einer Aufgabe, die ein 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 Zusammenführen nichts verändert.

Inhaber und Administratoren starten den Assistenten. Beginnen Sie ihn über Lokalisierung: wählen Sie Ein Projekt internationalisieren, oder Den Assistenten starten in der Zeile eines Projekts. Bei einem bereits mehrsprachigen Projekt Einstellungen → Sprachen ändern öffnet den gleichen Assistenten, um Änderungen vorzuschlagen.

Die Schritte#

1. Scannen#

Coroid liest den Standardzweig aus, ohne dabei Code auszuführen. Er sucht nach Katalogen und ihren Sprachen, den verwendeten Frameworks sowie Texten, die noch direkt im Code stehen – jeweils pro Datei gezählt.

• Gefundene Kataloge. 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 aus ihr übersetzt. Der Assistent erkennt sie anhand Ihrer Kataloge oder schätzt sie aus dem Text im Code ab. 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, und Schweizerdeutsch aus Hochdeutsch mit schweizerischer Rechtschreibung – dadurch entstehen keine Kosten und sie bleiben mit ihrer Ursprungssprache im Einklang.

4. Zeichenketten#

Beim Übernehmen wählen Sie die Kataloge aus, die Coroid übersetzt behält; 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 anzuwenden:

• 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 bleiben unverändert. Produkt-, Marken- und Funktionennamen, 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. Qualität und Automatisierung#

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

• Übersetzungen bei jeder Änderung prüfen. Die Prüfung von Übersetzungen in der Qualitätskontrolle sendet bei fehlenden oder fehlerhaften Zeichenketten eine Rückmeldung.
• Zeichenketten übersetzen, die außerhalb von Coroid zusammengeführt wurden. Wenn jemand neuen Text ohne Coroid zusammenführt, wird eine Aufgabe zur Übersetzung gestartet.
• Korrekturen jede Nacht anwenden. Genehmigte Vorschläge von Mitwirkenden kommen jede Nacht als eine pull request zusammen.
• Eingeladene Personen sollen Wortvorschläge machen dürfen. Eingeladene Muttersprachler können Übersetzungen auf Ihrer Seite korrigieren. Sehen Sie sich Übersetzungen mit Vorschlägen pflegen.

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

7. Rezension#

Eine Zusammenfassung des Projekts, was die Aufgabe bewirken wird, die Quellsprache, die Sprachen – einschließlich der abgeleiteten –, das Übersetzungsvolumen, die unveränderten Begriffe und welche Funktionen nach dem Zusammenführen aktiviert werden. Die Übersetzung wird wie andere Agentenarbeit als Modellnutzung abgerechnet und pro Aufgabe gedeckelt.

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

Was die Aufgabe tut#

• Übernehmen Die Konfigurationsdatei wird exakt so geschrieben, wie der Assistent sie erstellt hat, anschließend werden alle fehlenden Zeichenfolgen übersetzt.
• Vorstellung Der Assistent verknüpft Ihr Framework, verschiebt den Text der ausgewählten Dateien in Kataloge, fügt Sprachrouting, Fallback-Optionen und Rechts-zu-Links-Unterstützung hinzu und übersetzt anschließend.
• Änderung Die neue Konfiguration wird geschrieben und die durch die Änderung betroffenen Übersetzungen werden repariert.

Die Aufgabe endet in einem pull request. Sobald dieser in den Standardbranch gemergt wird, erscheinen alle Sprachen in der Lokalisierung.

Formate#

Coroid liest Kataloge in diesen Formaten ein:

Die Konfigurationsdatei#

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

{
  "version": 1,
  "cli": { "version": "1.9.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)."
  }
}

• cli Die exakte Engine-Version und ihr Prüfsummenwert werden festgelegt. Coroid lädt diese Version herunter und verifiziert sie vor jedem Ausführungsvorgang, sodass ein Update Ihre Ausgabe nicht unerwartet verändert.
• derivedLocales Es listet die durch die Regeln erzeugten regionalen Varianten auf.
• protectedTerms und localeInstructions enthalten die von Ihnen gewählten Einstellungen unter Stil und Begriffe.

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

Einstellungen → Konfigurationsdatei in der Arbeitsumgebung 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 repariert. Für Sprachen und Stil ist der Assistent der einfachere Weg.

Verwandt#

• Lokalisierung
• Übersetzungen mit Vorschlägen pflegen
• Spezifikationen