Übersicht

Die Funktion getGT ist eine asynchrone Funktion, um Zeichenketten zur Build-Zeit zu übersetzen.

const t = await getGT();

<p>{  t('Dieser Text wird übersetzt')  }</p>;

Referenzen

Parameter

Keine

Rückgabe

Ein Promise mit einer Callback-Funktion t, die den übergebenen Inhalt übersetzt.

Promise<(content: string, options?: InlineTranslationOptions) => string>

Verhalten

Produktion

Während des CD-Prozesses (Continuous Delivery/Deployment) wird sämtlicher Inhalt innerhalb einer t-Funktion übersetzt, bevor Ihre Anwendung bereitgestellt wird. Das gewährleistet schnelle Ladezeiten für alle locales, kann jedoch nur Inhalte übersetzen, die zur Build-Zeit bekannt sind.

Nach der Generierung werden Übersetzungen entweder (1) im CDN (Content Delivery Network) gespeichert oder (2) im Build-Output Ihrer App abgelegt, je nach Konfiguration. Von dort wird der übersetzte Inhalt an Ihre Nutzer ausgeliefert. Wenn keine Übersetzung gefunden wird, wird als Standardwert auf den originalen Inhalt zurückgegriffen.

Stellen Sie sicher, dass Sie die Bereitstellungsanleitung hier befolgen.

Entwicklung

Während der Entwicklung übersetzt die Funktion t Inhalte bei Bedarf. Das ist hilfreich, um zu sehen, wie Ihre App in verschiedenen Sprachen aussehen wird. Denken Sie daran, Ihrer Umgebung einen Dev-API-Schlüssel hinzuzufügen, um dieses Verhalten zu aktivieren.

Bei On-Demand-Übersetzungen kommt es in der Entwicklung zu einer Verzögerung. Dies tritt in Produktions-Builds nicht auf, es sei denn, Inhalte werden ausdrücklich bei Bedarf übersetzt, also z. B. mit tx oder <Tx>.

Beispiel

Grundlegende Verwendung

Sie können getGT verwenden, um Strings zu übersetzen.

import { getGT } from 'gt-next/server';

export default async function TranslateGreeting() {
  const t = await getGT();

  return (
    <p>
      {t('Hallo, Alice!')}
    </p>
  );
}

Hinweis: „Alice“ wird in die bevorzugte Sprache des Nutzers übersetzt.

Verwendung von variables

Sie können variables an Wörterbuch-Übersetzungen übergeben.

import { getGT } from 'gt-next/server';

export default async function TranslateGreeting() {
  const t = await getGT();

  return (
    <p>
      {t('Hallo, {name}!', { name: 'Alice' })}
    </p>
  );
}

Hinweis: "Alice" wird nicht in die bevorzugte Sprache des Benutzers übersetzt, da es sich um eine Variable handelt.

Verwendung des ICU Message Format

gt-next unterstützt das ICU Message Format, mit dem Sie auch Ihre variables formatieren können.

import { getGT } from 'gt-next/server';

export default async function TranslateGreeting() {
  const t = await getGT();
  return (
    <p>
      {t('Es {count, plural, =0 {sind keine Artikel} =1 {ist ein Artikel} other {sind {count} Artikel}} im Warenkorb', { count: 10 })}
    </p>
  );
}

Hinweise

• Die Funktion getGT ist eine serverseitige Funktion, die Strings übersetzt.
• Übersetzungen mit getGT erfolgen vor der Laufzeit, während des Build-Prozesses (außer im Development-Modus).

Nächste Schritte

• Siehe useGT für clientseitige Zeichenkettenübersetzungen zur Build‑Zeit.
• Für Übersetzungen zur Laufzeit siehe tx und <Tx>.