i18n-Konfiguration

Überblick

Die Funktion withGTConfig() initialisiert die Einstellungen für General Translation (GT) in einer Next.js-Anwendung. Durch die Übergabe von Props an diese Funktion können wir das Internationalisierungsverhalten (i18n) der App steuern. Dazu gehören die Festlegung der Standardsprache (auch bekannt als Fallback-Sprache), unterstützte Sprachen und andere übersetzungsbezogene Optionen.

Hinzufügen des Plugins

Der erste Schritt besteht darin, die Plugin-Funktion withGTConfig() zu Ihrer Next-Konfigurationsdatei hinzuzufügen.

Auffinden Ihrer Next-Konfigurationsdatei

Im Stammverzeichnis Ihres Projekts sollte sich eine Datei namens next.config.js (oder .ts, .mjs, .cjs) befinden.

Plugin hinzufügen

Richten Sie eine grundlegende Konfiguration für das Plugin in Ihrer next.config.js Datei ein. Diese wird auf die Standardwerte zurückgreifen.

import { withGTConfig } from 'gt-next/config';
 
const nextConfig = {}
 
export default withGTConfig(nextConfig);

Einige Beispiele

Grundlegende Verwendung

In dieser Konfiguration geben wir an, dass die App in Englisch, Spanisch und Französisch verfügbar ist. Wir geben auch an, dass die Standardsprache Englisch ist. Wir fügen auch die Beschreibung "Ein persönlicher Blog über Technologie und Reisen" hinzu. Diese Beschreibung wird bei jeder durchgeführten Übersetzung berücksichtigt.

import { withGTConfig } from 'gt-next/config'
 
const nextConfig = {}
 
export default withGTConfig(nextConfig, {
  defaultLocale: "en-US", // die Standardsprache Ihrer App, normalerweise "en" oder "en-US"
  locales: ["en-US", "es", "fr"], // die Sprachen, in denen Ihre App verfügbar ist
  description: "Eine persönliche Website für John Smith" // eine natürliche Sprachbeschreibung Ihrer Website, die bei der Übersetzung hilft
});

Lokale einbeziehen

withGTConfig() ermöglicht es Ihnen, eine Liste von Lokalen anzugeben, die Sie einbeziehen möchten. Zum Beispiel gibt diese Konfiguration an, dass die App in Englisch, Chinesisch und Japanisch verfügbar gemacht wird.

Das bedeutet, dass die App nur in diesen Sprachen verfügbar sein wird. Alle Lokale, die nicht in dieser Liste enthalten sind, werden nicht übersetzt. Wenn ein Benutzer beispielsweise versucht, auf die App in einer nicht aufgeführten Sprache zuzugreifen, wird die App auf das angegebene Standardlokal zurückgesetzt.

import { withGTConfig } from 'gt-next/config'
 
const nextConfig = {}
 
export default withGTConfig(nextConfig, {
  defaultLocale: "en-US",
  locales: ["en-US", "zh", "jp"]
});

Um eine Liste der unterstützten Lokale zu sehen, beziehen Sie sich auf die Unterstützten Lokale. Für eine detailliertere Anleitung zur Auswahl von Lokalen, beziehen Sie sich auf den Lokale-Management-Leitfaden.

Konfiguration von getLocale()

i18n ist ein String, der einen benutzerdefinierten Pfad zu einer Datei angibt, die eine getLocale()-Funktion definiert. Sie können benutzerdefiniertes Verhalten zur Bestimmung des Benutzerlokals angeben, indem Sie eine Datei erstellen, die eine Funktion namens getLocale() exportiert.

import { withGTConfig } from 'gt-next/config'
 
const nextConfig = {};
 
export default withGTConfig(nextConfig, {
  defaultLocale: "en-US", // die Standardsprache Ihrer App, normalerweise "en" oder "en-US"
  i18n: "./i18n.js"
});

import { cookies } from "next/headers";
 
export async function getLocale() {
  const cookieStore = await cookies();
  return cookieStore.get('myCustomLocaleCookie') || 'en';
}

Bevorzugter Anbieter

preferredModelProvider ermöglicht es Ihnen, einen bevorzugten Modellanbieter anzugeben. Derzeit sind nur Anthropic und OpenAI aktiviert, aber in Zukunft werden weitere Anbieter hinzugefügt.

Wir leiten alle Ihre Übersetzungen an Ihren bevorzugten LLM-Anbieter weiter, aber wenn Ihr bevorzugtes Modell nicht verfügbar oder nicht leicht zugänglich ist, greifen wir auf einen anderen Anbieter zurück.

import { withGTConfig } from 'gt-next/config'
 
const nextConfig = {};
 
export default withGTConfig(nextConfig, {
  defaultLocale: "en-US",
  preferredModelProvider: "anthropic"
});

Notizen

• withGTConfig() ermöglicht es Ihnen, das Verhalten von GT in Ihrer Next.js-Anwendung zu konfigurieren.
• Sie können die Standardsprache, unterstützte Sprachen und andere übersetzungsbezogene Optionen angeben.

Nächste Schritte

• Lesen Sie die API-Dokumentation für withGTConfig().