# General Translation Platform: Démarrage rapide
URL: https://generaltranslation.com/fr/docs/platform/core/quickstart.mdx
---
title: Démarrage rapide
description: Découvrez ce que fait la bibliothèque principale `generaltranslation`, quand l’utiliser et comment traduire votre première chaîne.
related:
  links:
    - /docs/platform/core/guides/translating-strings
    - /docs/platform/core/guides/translating-files
    - /docs/platform/core/guides/locale-codes

---

La bibliothèque `generaltranslation` est la bibliothèque principale d’i18n de General Translation pour la traduction, le formatage et les utilitaires de paramètres régionaux.

La plupart des applications basées sur un framework devraient commencer par [gt-react ou gt-next](/docs/react/overview). Utilisez `generaltranslation` directement si vous voulez un contrôle plus granulaire, un workflow personnalisé ou des utilitaires de traduction en dehors d’une intégration à un framework.

## Ce que fait `generaltranslation` [#what-it-does]

`generaltranslation` vous donne un accès direct à :

* **Traduction de chaînes** pour traduire des chaînes ou du contenu structuré depuis votre code.
* **Traduction de fichiers** pour téléverser des fichiers source, mettre des tâches de traduction en file d’attente, vérifier leur état et télécharger le contenu traduit.
* **Utilitaires de paramètres régionaux** pour valider, comparer, résoudre et afficher des codes de langue.
* **Utilitaires de formatage** pour gérer les nombres, les dates, les messages, les listes et le temps relatif en fonction du paramètre régional.

## Quand utiliser `generaltranslation` [#when-to-use]

Utilisez `generaltranslation` lorsque vous avez besoin de :

* Traduire du contenu à partir d’un script, d’un service back-end, d’un worker ou d’une étape de build personnalisée.
* Envoyer et télécharger des fichiers de traduction sans utiliser la CLI.
* Créer une automatisation de traduction personnalisée autour des fichiers du projet, des jobs, des branches ou des tags.
* Formater des nombres, des dates, des messages ou des noms de paramètres régionaux en dehors de React ou Next.js.
* Partager le comportement de GT entre des packages qui n’utilisent pas le même framework front-end.

## Démarrage rapide [#quickstart]

Installez `generaltranslation`, créez une instance de [GT](/docs/platform/core/reference/gt-class/constructor) avec l’ID de votre projet et votre clé API, puis traduisez votre première chaîne de caractères.

### 1. Installez `generaltranslation`

<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>

### 2. Obtenir une clé API

Créez un `GT_PROJECT_ID` et une `GT_API_KEY` dans le Dashboard. Ouvrez la [page API Keys](https://dash.generaltranslation.com/api-keys), cliquez sur **Create API Key**, saisissez un nom, puis confirmez.

```bash
GT_PROJECT_ID=your-project-id
GT_API_KEY=your-api-key
```

General Translation offre des quotas gratuits généreux pour les projets personnels, les développeurs indépendants et la communauté.

### 3. Initialiser la classe GT

Initialisez la classe [GT](/docs/platform/core/reference/gt-class/constructor) et transmettez en toute sécurité votre `GT_PROJECT_ID` et votre `GT_API_KEY`.

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

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

Vous pouvez configurer les paramètres régionaux par défaut de l’instance [GT](/docs/platform/core/reference/gt-class/constructor). Utilisez-les lorsque la plupart des appels utilisent le même paramètre régional source ou cible.

```typescript title="src/index.ts"
const gt = new GT({
  projectId: 'your-project-id',
  apiKey: 'your-api-key',
  sourceLocale: 'en',
  targetLocale: 'es',
});
```

Consultez [classe GT](/docs/platform/core/reference/gt-class/constructor) pour connaître toutes les options du constructeur.

### 4. Traduisez votre première chaîne

Appelez la méthode [translate](/docs/platform/core/reference/gt-class-methods/translation/translate) pour traduire votre première chaîne. Passez la chaîne à traduire ainsi que le paramètre régional cible.

```typescript title="src/index.ts"
const result = await gt.translate('Hello, world!', 'es');

if (result.success) {
  console.log(result.translation); // "¡Hola, mundo!"
} else {
  console.error(`Translation failed: ${result.error}`);
}
```

Les méthodes de traduction nécessitent une clé API et un ID de projet. Les utilitaires de formatage et de paramètres régionaux peuvent être utilisés sans accès à l’API de traduction.
## Next steps

- /docs/platform/core/guides/translating-strings
- /docs/platform/core/guides/translating-files
- /docs/platform/core/guides/locale-codes