# sanity: Introduction
URL: https://generaltranslation.com/fr/docs/sanity.mdx
---
title: Introduction
description: Présentation du plugin General Translation pour Sanity CMS
---

## Vue d’ensemble

Le plugin `gt-sanity` intègre General Translation directement à Sanity Studio v5+.
Il offre un flux de travail de traduction complet pour votre contenu Sanity, notamment la traduction automatique, la traduction au niveau du document et la gestion des documents traduits.

```typescript title="sanity.config.ts"
import { defineConfig } from 'sanity';
import { gtPlugin } from 'gt-sanity';

export default defineConfig({
  // ... votre configuration existante
  plugins: [
    gtPlugin({
      sourceLocale: 'en',
      locales: ['es', 'zh', 'ja'],
    }),
  ],
});
```


## Fonctionnement

Le plugin utilise l’approche de [localisation au niveau du document](https://www.sanity.io/docs/studio/localization) de Sanity : pour chaque document source, il crée des documents traduits distincts avec un champ `language` défini sur le paramètre régional cible.

<Callout type="warn">
  **Modifications du schéma et des requêtes requises.** Chaque type de document que vous traduisez doit inclure un champ `language` dans son schéma (voir ci-dessous).
  Vous devrez également mettre à jour vos requêtes frontend pour récupérer la bonne version linguistique.
  Consultez le [démarrage rapide](/docs/sanity/guides/quickstart#querying-translated-content) pour la configuration et des exemples de requêtes GROQ.
</Callout>

### Champ de langue

Chaque type de document que vous traduisez doit définir un champ `language` :

```typescript
import { defineField, defineType } from 'sanity'

export const articleType = defineType({
  name: 'article',
  title: 'Article',
  type: 'document',
  fields: [
    // ... vos champs existants
    defineField({
      name: 'language',
      type: 'string',
      readOnly: true,
      hidden: true,
    }),
  ],
})
```

Si vous utilisez un nom personnalisé pour `languageField` dans la configuration de votre plugin, le nom du champ doit être identique.

## Principales fonctionnalités

### Traduction de documents

Traduisez des documents entiers dans plusieurs paramètres régionaux cibles. Le plugin gère Portable Text, les objets imbriqués, les tableaux et les types de schéma personnalisés.

### Opérations par lot

Traduisez plusieurs documents ou l’ensemble de votre site en une seule fois. Importez toutes les traductions, uniquement les traductions manquantes, ou sélectionnez celles à importer par paramètre régional.

### Sérialisation intelligente

Les documents sont sérialisés en HTML pour la traduction, tout en préservant leur structure et leurs métadonnées.
Pour les langues dont la structure grammaticale diffère, celle des traductions est automatiquement adaptée afin de paraître naturelle dans la langue cible.

Les sérialiseurs personnalisés vous permettent de contrôler la façon dont certains types de champs sont traités.

## Interface du plugin

Le plugin fournit trois composants d’interface utilisateur principaux :

### Action Traduire (boîte de dialogue)

L’action Traduire est ajoutée automatiquement à chaque document. Un clic sur le bouton **Traduire** dans la barre d’actions du document ouvre une boîte de dialogue avec l’interface de traduction complète — aucune configuration supplémentaire n’est nécessaire.

### Onglet Traductions (facultatif)

![TranslationsTab](https://assets.gtx.dev/docs/sanity-translations-tab.png)

`TranslationsTab` peut être ajouté de façon facultative comme vue de document dédiée via `structureTool`. Il offre les mêmes fonctionnalités de traduction que la boîte de dialogue, intégrées sous forme d’onglet dans l’éditeur de documents.

Consultez le [démarrage rapide](/docs/sanity/guides/quickstart#configuration) pour les instructions de configuration.

### Page des traductions

![TranslationsPage](https://assets.gtx.dev/docs/sanity-translations-page.png)

La page des traductions est une page Sanity qui offre une vue d’ensemble des traductions de tout votre site.
Depuis cette page de gestion centralisée, vous pouvez :

* Générer en masse les traductions de tous les documents
* Importer en masse les traductions de tous les documents
* Importer en masse les traductions de documents spécifiques
* Réparer les références de langue et les liens vers d’autres documents
* Publier en masse les traductions de tous les documents

## Types de contenu pris en charge

Le plugin prend en charge la plupart des types de schéma de Sanity.

Les types personnalisés peuvent être configurés à l’aide de [sérialiseurs personnalisés](/docs/sanity/guides/serialization).

Les champs comme les slugs peuvent être configurés avec `dedupeFields` afin que les nouveaux documents traduits commencent avec une valeur dérivée de la source et un suffixe de paramètre régional unique, comme `about-es` ou `about-fr`.

## Prochaines étapes

* [Démarrage rapide](/docs/sanity/guides/quickstart) - Commencez par l’installation et la configuration
* [Guide de configuration](/docs/sanity/guides/configuration) - Personnalisez le comportement du plugin
* [Guide de sérialisation](/docs/sanity/guides/serialization) - Définissez des règles de sérialisation personnalisées