# generaltranslation: General Translation Core SDK: Vue d’ensemble
URL: https://generaltranslation.com/fr/docs/core.mdx
---
title: Vue d’ensemble
description: Présentation de la bibliothèque generaltranslation
---

## Introduction

La bibliothèque `generaltranslation` est la bibliothèque i18n principale de GT. Elle regroupe des fonctions utilitaires et des classes dédiées à la traduction et au formatage.
Elle est souvent utilisée avec des packages de framework comme `gt-next` et `gt-react`, mais peut aussi être utilisée comme bibliothèque autonome.

import Video from '@/components/Video';

<Video src="https://assets.gtx.dev/core-demo.mp4" />

```typescript title="index.ts"
import { GT } from 'generaltranslation';

const gt = new GT({
  apiKey: 'your-api-key',
  projectId: 'your-project-id',
  sourceLocale: 'en',
  targetLocale: 'es',
});

// Traduire le contenu
const result = await gt.translate('Hello, world!', 'es');
// "¡Hola, mundo!"

// Formater les nombres, les dates, les devises
const formattedPrice = gt.formatNum(29.99, { style: 'currency', currency: 'USD' });
const formattedDate = gt.formatDateTime(new Date());
// "$29.99"
// "9/25/2025"

// Travailler avec les paramètres régionaux
const localeProps = gt.getLocaleProperties('fr-CA');
const isValid = gt.isValidLocale('de');
// { language: "fr", region: "CA", ... }
// true
```

***


## Installation

<Tabs items={['npm', 'yarn', 'bun', 'pnpm']}>
  <Tab value="npm">
    ```bash
    npm install generaltranslation
    ```
  </Tab>

  <Tab value="yarn">
    ```bash
    yarn add generaltranslation
    ```
  </Tab>

  <Tab value="bun">
    ```bash
    bun add generaltranslation
    ```
  </Tab>

  <Tab value="pnpm">
    ```bash
    pnpm add generaltranslation
    ```
  </Tab>
</Tabs>

***

## Exemples

Il existe deux principaux types de traduction : la traduction de chaînes et la traduction de fichiers.

### Configuration

Pour activer la traduction, vous devez fournir un ID de projet et une clé API.
Consultez la méthode [`constructor`](/docs/core/class/constructor) pour en savoir plus.

```typescript
const gt = new GT({
  apiKey: 'your-api-key',
  projectId: 'your-project-id',
  targetLocale: 'es',
});
```


### Traduction de chaînes

Consultez la méthode [`translate`](/docs/core/class/methods/translation/translate) pour plus d’informations.

```typescript
try {
  const result = await gt.translate('Hello, world!');
  console.log(result); // "¡Hola, mundo!"
} catch (error) {
  console.error('Échec de la traduction :', error.message);
}
```


### Traduction de fichiers

Les fichiers sont traduits sous forme de tâches.
Une tâche est lancée lorsque vous importez un fichier.
L’import de plusieurs fichiers lance plusieurs tâches.

Consultez les méthodes [`uploadSourceFiles`](/docs/core/class/methods/translation/upload-source-files)
et [`queryFileData`](/docs/core/class/methods/translation/query-file-data) pour en savoir plus.

```typescript
// Fichiers à uploader
const files = [
  {
    source: {
      fileName: 'src/components/Button.tsx',
      fileFormat: 'TSX',
      locale: 'en',
      content: '...',
    },
  },
];

// Uploader les fichiers sources
await gt.uploadSourceFiles(files);
```

***


## Table des matières

### Classe GT

Classe principale pour la traduction et la gestion des paramètres régionaux :

* **[Constructor](/docs/core/class/constructor)** - Initialiser l’instance GT avec la configuration
* **[setConfig](/docs/core/class/set-config)** - Mettre à jour la configuration de l’instance GT

#### Méthodes de traduction

* **[translate](/docs/core/class/methods/translation/translate)** - Fonction principale de traduction
* **[translateMany](/docs/core/class/methods/translation/translate-many)** - Traduction par lot
* **[setupProject](/docs/core/class/methods/translation/setup-project)** - Initialisation du projet
* **[checkJobStatus](/docs/core/class/methods/translation/check-job-status)** - Vérifier l’avancement de la tâche
* **[getProjectData](/docs/core/class/methods/translation/get-project-data)** - Récupérer les informations du projet
* **[uploadSourceFiles](/docs/core/class/methods/translation/upload-source-files)** - Importer des fichiers à traduire
* **[uploadTranslations](/docs/core/class/methods/translation/upload-translations)** - Importer des traductions existantes
* **[enqueueFiles](/docs/core/class/methods/translation/enqueue-files)** - Mettre des fichiers en file d’attente pour traitement
* **[queryFileData](/docs/core/class/methods/translation/query-file-data)** - Vérifier l’état de la traduction
* **[downloadFile](/docs/core/class/methods/translation/download-file)** - Télécharger un fichier unique
* **[downloadFileBatch](/docs/core/class/methods/translation/download-file-batch)** - Télécharger plusieurs fichiers
* **[querySourceFile](/docs/core/class/methods/translation/query-source-file)** - Consulter les informations du fichier source

#### Méthodes de formatage

* **[formatMessage](/docs/core/class/methods/formatting/format-message)** - Formatage de texte internationalisé
* **[formatNum](/docs/core/class/methods/formatting/format-num)** - Formatage des nombres
* **[formatDateTime](/docs/core/class/methods/formatting/format-date-time)** - Formatage des dates et heures
* **[formatRelativeTime](/docs/core/class/methods/formatting/format-relative-time)** - Formatage du temps relatif avec unité explicite
* **[formatRelativeTimeFromDate](/docs/core/class/methods/formatting/format-relative-time-from-date)** - Formatage du temps relatif à partir d&#39;une Date
* **[formatCutoff](/docs/core/class/methods/formatting/format-cutoff)** - Formatage de la troncature de texte
* **[formatListToParts](/docs/core/class/methods/formatting/format-list-to-parts)** - Formatage d&#39;une liste en parties

#### Méthodes des paramètres régionaux

* **[getLocaleName](/docs/core/class/methods/locales/get-locale-name)** - Obtenir le nom d’affichage du paramètre régional
* **[getLocaleProperties](/docs/core/class/methods/locales/get-locale-properties)** - Obtenir des informations complètes sur le paramètre régional
* **[getLocaleDirection](/docs/core/class/methods/locales/get-locale-direction)** - Obtenir la direction du texte du paramètre régional
* **[getLocaleEmoji](/docs/core/class/methods/locales/get-locale-emoji)** - Obtenir l’emoji de drapeau du paramètre régional
* **[getRegionProperties](/docs/core/class/methods/locales/get-region-properties)** - Obtenir les informations et propriétés de la région
* **[isValidLocale](/docs/core/class/methods/locales/is-valid-locale)** - Valider le code de langue
* **[resolveAliasLocale](/docs/core/class/methods/locales/resolve-alias-locale)** - Convertir les paramètres régionaux standard en alias
* **[resolveCanonicalLocale](/docs/core/class/methods/locales/resolve-canonical-locale)** - Convertir les alias de paramètre régional en forme standard
* **[standardizeLocale](/docs/core/class/methods/locales/standardize-locale)** - Standardiser le format du code de langue
* **[isSameDialect](/docs/core/class/methods/locales/is-same-dialect)** - Vérifier si les paramètres régionaux correspondent au même dialecte
* **[isSameLanguage](/docs/core/class/methods/locales/is-same-language)** - Vérifier si les paramètres régionaux correspondent à la même langue
* **[isSupersetLocale](/docs/core/class/methods/locales/is-superset-locale)** - Vérifier les relations hiérarchiques entre paramètres régionaux
* **[determineLocale](/docs/core/class/methods/locales/determine-locale)** - Trouver le paramètre régional le plus adapté à partir des préférences
* **[requiresTranslation](/docs/core/class/methods/locales/requires-translation)** - Déterminer si une traduction est nécessaire

### Fonctions utilitaires

#### Fonctions de formatage

* **[formatMessage](/docs/core/functions/formatting/format-message)** - Formatage autonome du texte
* **[formatNum](/docs/core/functions/formatting/format-num)** - Formatage autonome des nombres
* **[formatDateTime](/docs/core/functions/formatting/format-date-time)** - Formatage autonome des dates et heures

- **[formatRelativeTime](/docs/core/functions/formatting/format-relative-time)** - Formatage autonome du temps relatif
- **[formatRelativeTimeFromDate](/docs/core/functions/formatting/format-relative-time-from-date)** - Formatage autonome du temps relatif à partir d’un objet Date
- **[formatCutoff](/docs/core/functions/formatting/format-cutoff)** - Formatage autonome de la troncature de texte
- **[formatListToParts](/docs/core/functions/formatting/format-list-to-parts)** - Formatage autonome des listes en parties

#### Fonctions liées aux paramètres régionaux

* **[getLocaleName](/docs/core/functions/locales/get-locale-name)** - Utilitaire autonome de nom de paramètre régional
* **[getLocaleProperties](/docs/core/functions/locales/get-locale-properties)** - Utilitaire autonome des propriétés du paramètre régional
* **[getLocaleDirection](/docs/core/functions/locales/get-locale-direction)** - Utilitaire autonome de direction du texte
* **[getLocaleEmoji](/docs/core/functions/locales/get-locale-emoji)** - Utilitaire autonome d’emoji
* **[getRegionProperties](/docs/core/functions/locales/get-region-properties)** - Utilitaire autonome des propriétés de région
* **[isValidLocale](/docs/core/functions/locales/is-valid-locale)** - Validation autonome du paramètre régional
* **[resolveAliasLocale](/docs/core/functions/locales/resolve-alias-locale)** - Résolution autonome des alias de paramètres régionaux
* **[standardizeLocale](/docs/core/functions/locales/standardize-locale)** - Standardisation autonome du paramètre régional
* **[isSameDialect](/docs/core/functions/locales/is-same-dialect)** - Comparaison autonome des dialectes
* **[isSameLanguage](/docs/core/functions/locales/is-same-language)** - Comparaison autonome des langues
* **[isSupersetLocale](/docs/core/functions/locales/is-superset-locale)** - Vérification autonome de la hiérarchie des paramètres régionaux
* **[determineLocale](/docs/core/functions/locales/determine-locale)** - Négociation autonome du paramètre régional
* **[requiresTranslation](/docs/core/functions/locales/requires-translation)** - Vérification autonome de la nécessité de traduction

### Types et interfaces

Définitions TypeScript :

* **[GTConstructorParams](/docs/core/types/gt-constructor-params)** - Options de configuration
* **[LocaleProperties](/docs/core/types/locale-properties)** - Informations complètes sur le paramètre régional
* **[TranslationResult](/docs/core/types/translation-result)** - Types de réponse de traduction
* **[TranslateManyResult](/docs/core/types/translate-many-result)** - Réponse de traduction par lot
* **[FileToTranslate](/docs/core/types/file-to-translate)** - Configuration de traduction de fichier
* **[EnqueueFilesOptions](/docs/core/types/enqueue-files-options)** - Options de mise en file d’attente des fichiers
* **[Entry](/docs/core/types/Entry)** - Structure d’une entrée de traduction
* **[EntryMetadata](/docs/core/types/entry-metadata)** - Métadonnées de l’entrée
* **[Content](/docs/core/types/Content)** - Définitions du type de contenu
* **[Variable](/docs/core/types/Variable)** - Structure de variable
* **[VariableType](/docs/core/types/variable-type)** - Définitions du type de variable
* **[JsxElement](/docs/core/types/jsx-element)** - Type d’élément JSX
* **[JsxChild](/docs/core/types/jsx-child)** - Type d’enfant JSX
* **[JsxChildren](/docs/core/types/jsx-children)** - Type d’enfants JSX
* **[DataFormat](/docs/core/types/data-format)** - Spécifications du format de données
* **[CustomMapping](/docs/core/types/custom-mapping)** - Configuration de mappage personnalisé

***

## Prochaines étapes

* **[Prise en main de la classe GT](/docs/core/class/constructor)**
* **[Explorer les méthodes de traduction](/docs/core/class/methods/translation/translate)**
* **[Découvrir les utilitaires de paramètres régionaux](/docs/core/class/methods/locales/get-locale-name)**
* **[Consulter les options de formatage](/docs/core/class/methods/formatting/format-message)**
* **[Parcourir les fonctions autonomes](/docs/core/functions/formatting/format-message)**

Pour une utilisation propre à un framework, consultez la documentation [Next.js](/docs/next) ou [React](/docs/react).