Verwalten von Sprachversionen

Überblick

Dieses Dokument bietet Anleitungen zur Verwaltung von Lokalisierungen in Ihrer Next.js-Anwendung mit dem gt-next. Wir werden die Konfiguration der Liste der unterstützten Lokalisierungen durchgehen und dann die Generierung von Übersetzungen auslösen.

Diese Bibliothek verwendet den BCP-47-Standard, um Lokalisierungen zu definieren. Eine Liste der derzeit unterstützten Lokalisierungen finden Sie hier.

Konfigurieren von Gebietsschemas

Es gibt zwei Möglichkeiten, Ihre Gebietsschemas für die Produktion zu ändern:

1. Das CLI-Tool
2. Die gt.config.json Datei (bevorzugt)

Damit die Übersetzung durchgeführt werden kann, müssen Sie den Übersetzungsbefehl zu Ihrem Build-Skript hinzufügen:

{
  "scripts": {
    "build": "npx gtx-cli translate && next build"
  }
}

Dies wird die notwendigen Übersetzungen generieren und je nach Konfiguration in der Cloud oder in Ihrem lokalen Dateisystem speichern.

Verwalten von Gebietsschemas mit dem CLI-Tool

Der einfachste Weg, Gebietsschemas zu verwalten, ist, sie durch den npx gtx-cli translate Befehl mit dem --locales Flag anzugeben.

{
  "scripts": {
    "build": "npx gtx-cli translate --locales en-US zh jp && <YOUR_BUILD_COMMAND>"
  }
}

Dies wird Übersetzungen für Chinesisch (zh) und Japanisch (jp) generieren.

Verwendung von gt.config.json (bevorzugt)

Eine robustere Möglichkeit, Gebietsschemas zu verwalten, ist die Verwendung der gt.config.json Datei. Sie können die Liste der unterstützten Gebietsschemas mit der locales Eigenschaft angeben.

{
  "locales": ["zh", "jp"],
}

Whitelisted-Locales

Als optionale Funktion können Sie eine Liste von Whitelisted-Locales hinzufügen. Dies ist über das Dashboard auf der Seite Projekt-Locales zugänglich. Wenn Sie diese Funktion aktivieren, schlagen alle Versuche, npx translate mit nicht-whitelisted Locales aufzurufen, fehl.

Notizen

• Sie können die Sprachversionen über das Dashboard, die Datei gt.config.json oder das CLI-Tool verwalten.
• Die Verwendung von gt.config.json oder des CLI-Tools zur Verwaltung der Sprachversionen deaktiviert die Funktion Sprachversionen verwalten im Dashboard.

Nächste Schritte

• Erfahren Sie mehr über die Syntax der Gebietsschemata im Gebietsschema-Strings Referenz.