Wörterbücher

Überblick

Wörterbücher sind eine Möglichkeit, Textinhalte in General Translation zu übersetzen. Alle Inhalte werden in einer zentralen Datei gespeichert und können mit dem useDict() Hook abgerufen werden.

Wenn Sie andere i18n-Bibliotheken verwendet haben, sind Sie möglicherweise mit der Verwendung von Übersetzungsdateien (en.json, zh.json, usw.) vertraut. Die Verwendung von Wörterbüchern ist syntaktisch praktisch identisch, außer dass Sie nur eine Datei in Ihrer Basissprache pflegen müssen. Alle Übersetzungen werden von LLMs generiert.

Vorteile und Nachteile

Es gibt einige Vorteile bei der Verwendung von Wörterbüchern:

1. Zentralisierte Speicherung: Wörterbücher speichern alle übersetzbaren Inhalte in einer einzigen Datei, was die Verwaltung und Aktualisierung erleichtert.
2. Historischer Präzedenzfall: Das Wörterbuch-Muster ist ein gängiges Entwurfsmuster in der Branche und wird von vielen anderen Bibliotheken verwendet.

Gleichzeitig gibt es auch einige Nachteile:

1. Komplexität: Wörterbücher sind komplexer einzurichten und zu verwenden als die Übersetzung von Zeichenketteninhalten direkt im Code.
2. Lesbarkeit: Wörterbücher sind weniger lesbar als die Inline-Übersetzung, da der Inhalt vom Kontext getrennt ist, in dem er verwendet wird.
3. Wartbarkeit: Wörterbücher sind schwieriger zu warten als Inline-Übersetzungen, da Sie die Wörterbuchdatei manuell aktualisieren müssen, wenn sich Inhalte ändern.

Wörterbücher sind ein alternatives Entwurfsmuster zur Inline-Übersetzung, aber beide Muster werden von unserer Bibliothek unterstützt und schließen sich nicht gegenseitig aus. Sie können ein Wörterbuch zusammen mit der Inline-Übersetzung mit der <T> Komponente und dem useGT() Hook verwenden.

Beispiel

Geben Sie Ihre Textinhalte in einer Wörterbuchdatei an (entweder .js oder .json).

{
  "greetings": {
    "hello": 'Hello, World!',
  },
} 

Dann referenzieren Sie es in Ihrer Komponente, indem Sie den Schlüssel an die Funktion d() übergeben.

import { GTProvider, useDict } from 'gt-react';
import dictionary from './dictionary.json';
 
export default function MyComponent() {
 
  const d = useDict(); 
 
  return (
    <GTProvider dictionary={dictionary}>
      <div>
        {d('greetings.hello')} // [!code highlight]
      </div>
    </GTProvider>
  );
}

Hinweise

• Wörterbücher sind eine Möglichkeit, Inhalte in General Translation zu übersetzen.
• Der useDict() Hook wird für die Übersetzung von Strings mit dem Wörterbuchmuster verwendet.

Nächste Schritte

• Weitere Informationen finden Sie in den Anleitungen zu Wörterbüchern für React oder Next.js