Dictionnaires

Aperçu

Les dictionnaires sont un moyen de traduire du contenu textuel dans General Translation. Tout le contenu est stocké dans un fichier central et peut être accessible en utilisant le hook useDict().

Si vous avez utilisé d'autres bibliothèques i18n, vous êtes peut-être familier avec l'utilisation de fichiers de traduction (en.json, zh.json, etc.). L'utilisation des dictionnaires est pratiquement identique syntaxiquement, sauf que vous n'avez besoin de maintenir qu'un seul fichier dans votre langue de base. Toutes les traductions seront générées par des LLM.

Astuce: Si vous recherchez un moyen plus simple de traduire du contenu textuel, nous vous recommandons d'utiliser le hook useGT().

Avantages et inconvénients

Il y a quelques avantages à utiliser des dictionnaires :

Stockage centralisé : Les dictionnaires stockent tout le contenu traduisible dans un seul fichier, ce qui facilite la gestion et la mise à jour.
Précédent historique : Le modèle de dictionnaire est un modèle de conception courant dans l'industrie et est utilisé par de nombreuses autres bibliothèques.

En même temps, il présente également quelques inconvénients :

Complexité : Les dictionnaires sont plus complexes à configurer et à utiliser que la traduction de contenu en ligne.
Lisibilité : Les dictionnaires sont moins lisibles que la traduction en ligne car le contenu est séparé du contexte où il est utilisé.
Maintenabilité : Les dictionnaires sont plus difficiles à maintenir que la traduction en ligne car vous devez mettre à jour manuellement le fichier de dictionnaire lorsque le contenu change.

Les dictionnaires sont un modèle de conception alternatif à la traduction en ligne, mais les deux modèles sont pris en charge par notre bibliothèque et ne s'excluent pas mutuellement. Vous pouvez utiliser un dictionnaire parallèlement à la traduction en ligne avec le composant <T> et le hook useGT().

Exemple

Spécifiez votre contenu textuel dans un fichier de dictionnaire (soit .js ou .json).

src/dictionary.json

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

Ensuite, vous y faites référence dans votre composant en passant la clé à la fonction d().

src/MyComponent

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>
  );
}

Notes

Les dictionnaires sont un moyen de traduire du contenu dans General Translation.
Le hook useDict() est utilisé pour traduire des chaînes avec le modèle de dictionnaire.

Prochaines étapes

Pour plus d'informations, consultez les guides sur les dictionnaires pour React ou Next.js