Übersicht

Die Funktion getGT ist eine asynchrone Funktion zum Übersetzen von Strings zur Build‑Zeit.

const t = await getGT();

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

Referenzen

Parameter

Keine

Rückgabewert

Ein Promise für eine Callback‑Funktion t, die den bereitgestellten Inhalt übersetzt.

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

Verhalten

Produktion

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

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

Befolgen Sie unbedingt die Bereitstellungsanleitung hier.

Entwicklung

Während der Entwicklung übersetzt die Funktion t Inhalte bei Bedarf. Das ist hilfreich, um zu prototypisieren, wie deine App in verschiedenen Sprachen aussieht. Denke daran, einen Dev API key in deiner Umgebung zu hinterlegen, um dieses Verhalten zu aktivieren.

Bei bedarfsorientierter Übersetzung in der Entwicklung kann es zu einer Verzögerung kommen. Dies tritt bei Produktions-Builds nicht auf, es sei denn, Inhalte werden ausdrücklich bei Bedarf übersetzt, d. h. 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 Variablen

Sie können Variablen 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 vom Benutzer bevorzugte Sprache übersetzt, da es sich um eine Variable handelt.

Verwendung des ICU-Nachrichtenformats

gt-next unterstützt das ICU-Nachrichtenformat, mit dem Sie auch Variablen formatieren können.

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

export default async function TranslateGreeting() {
  const t = await getGT();
  return (
    <p>
      {t('Im Warenkorb {count, plural, =0 {befinden sich keine Artikel} =1 {befindet sich ein Artikel} other {befinden sich {count} Artikel}}', { 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).

Nächste Schritte

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