gt.config.json
Le fichier gt.config.json
Aperçu
Le fichier gt.config.json est responsable du stockage de la configuration de votre projet.
Il contient des informations essentielles comme le projectId de votre projet, les locales prises en charge, et plus encore.
Il stocke également des informations internes importantes, telles que le versionId de votre projet.
Ce fichier est lu par (1) votre composant <GTProvider> et (2) la commande gtx-cli translate.
Pour cette raison, nous recommandons de stocker votre configuration dans le fichier gt.config.json plutôt que de la passer en tant que prop à votre composant <GTProvider>.
De manière générale, tout ce qui commence par un underscore (p. ex. _versionId) est une propriété interne et ne doit pas être modifié.
Tout le reste peut être ajusté.
Champs
| Champ | Type | Description |
|---|---|---|
projectId | string | Identifiant unique de votre projet dans le système GT |
locales | string[] | Tableau des codes de locale pris en charge pour votre projet |
defaultLocale | string | Code de locale principal utilisé comme secours lorsque des traductions sont manquantes |
cacheUrl | string | URL de point de terminaison pour la mise en cache des données de traduction |
runtimeUrl | string | URL de point de terminaison pour les services de traduction à l’exécution |
stageTranslations | boolean | Paramétrage des fonctionnalités de traduction de staging/aperçu |
files | object | Chemin vers les files de traduction locales pour le développement et les tests |
_versionId | string | Propriété interne utilisée pour suivre la version du projet (ne pas modifier) |
cacheUrl et runtimeUrl
Si vous stockez vos traductions dans le cloud, cacheUrl est l’URL de base du cache.
runtimeUrl est l’URL de base de l’exécution et ne s’applique qu’aux traductions en environnement de développement.
stageTranslations
Le drapeau stageTranslations est un indicateur utilisé par l’outil gtx-cli pour signaler que vos traductions nécessitent une relecture.
Cela signifie qu’elles doivent être approuvées manuellement avant de pouvoir être déployées en production via la commande gtx-cli translate.
files
Le champ files indique le chemin vers des traductions stockées localement (par opposition à un stockage dans le cloud).
Plus précisément, le champ output indique l’emplacement où les traductions seront écrites.
{
"files": {
"gt": {
"output": "public/_gt/[locale].json"
}
},
}Consultez la documentation de configuration de la CLI — configuration docs — pour en savoir plus sur l’utilisation du champ files.
Exemples
Définir vos locales
{
"defaultLocale": "en", // La locale par défaut est l'anglais
"locales": ["fr", "es"] // Les locales secondaires sont le français et l'espagnol
}Notes
- Le fichier
gt.config.jsonsert à définir la configuration de votre projet. - Il est lu aussi bien par le composant
<GTProvider>que par la commandegtx-cli translate.
Prochaines étapes
Comment trouvez-vous ce guide ?