# General Translation Knowledge Base: Comment traduire du contenu dans Sanity ? URL: https://generaltranslation.com/fr/kb/translate-sanity-content.mdx Docs index: https://generaltranslation.com/llms.txt Description: Stockez chaque langue dans son propre document ou sous forme de valeur par paramètre régional dans chaque champ, puis traduisez la source dans chaque paramètre régional cible. Le plugin gt-sanity de General Translation ajoute une action Translate à Sanity Studio et, par défaut, importe chaque traduction sous forme de brouillon, que vous relisez puis publiez. Category: Outils de workflow Last updated: 2026-10-21 Authors: Kevin Liu, Kevin Wu Published: 2026-10-21 Pour traduire du contenu dans Sanity, vous stockez chaque langue soit dans un document distinct identifié par un champ de langue (localisation au niveau du document), soit sous forme de valeur par paramètre régional dans chaque champ (localisation au niveau des champs), puis vous renseignez chaque langue cible à partir de la source. L’exercice est délicat, car un document est constitué de données structurées : le Portable Text (le format de texte enrichi de Sanity) doit conserver ses blocs et ses marques ; les images, les dates et les nombres doivent être copiés tels quels ; avec un document par langue, chaque référence doit pointer vers la traduction correspondante ; enfin, les corrections apportées aux traductions par les éditeurs ne doivent pas être écrasées lors de la mise à jour suivante. ## Video The video is narrated in English, with English captions. [How do I translate content in Sanity?](https://caxecubb9c64cezv.public.blob.vercel-storage.com/films/kb-translate-sanity-content.mp4) (47 s) General Translation lets you click Translate on a Sanity document with the `gt-sanity` plugin. Add `gtPlugin` to `sanity.config.ts` with your locales and document types, give the article a language field, store your API key in a private document, publish the drafts the plugin imports, and query each language by its language field. ## Méthodes pour traduire du contenu Sanity | Approche | Points forts | Comment les traductions arrivent dans Sanity | Ce qui reste à votre charge | | ------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Les plugins de localisation de Sanity seuls | Stockent chaque langue dans un document distinct ou sous forme de valeur par paramètre régional dans chaque champ | Vos éditeurs ou traducteurs saisissent chaque langue dans Sanity Studio | Chaque traduction, ainsi que chaque mise à jour lorsque la source change | | Google Translate | Traduit le texte que vous collez, sans aucune configuration initiale | Copier-coller, ou un script qui écrit via l’API de Sanity | Il traduit chaque chaîne de caractères isolément ; découper le Portable Text en chaînes puis le reconstruire, copier les autres champs, rediriger les références, assurer la cohérence terminologique et relire restent à votre charge | | Un script reposant sur une API d’IA (OpenAI API, Claude API) | Traduit de nombreux documents en une seule exécution scriptée, en intégrant votre ton et votre terminologie dans le prompt | Un script qui écrit via l’API de Sanity | Découper et reconstruire le Portable Text, copier les autres champs, rediriger les références, fournir le contexte et la terminologie à chaque requête, et relire | | General Translation (`gt-sanity`) | Traduit le texte et le Portable Text en s’appuyant sur les groupes de contexte (glossaire et instructions personnalisées) de votre projet | Une action **Translate** dans Studio importe chaque paramètre régional sous forme de brouillon | Un champ de langue, un document d’informations d’authentification et une relecture avant publication | Utilisez uniquement les plugins de localisation de Sanity lorsque des traducteurs rédigent chaque langue et que le contenu change rarement ; optez pour Google Translate ou un script reposant sur une API d’IA pour des textes ponctuels relus avant publication. Choisissez General Translation lorsque vos documents contiennent du texte enrichi et des références, et évoluent régulièrement. ## Traduire des documents avec gt-sanity Le plugin `gt-sanity` de General Translation ajoute une action **Translate** à Sanity Studio et prend en charge les deux modèles, la traduction au niveau du document étant la valeur par défaut de `translationLevel`. 1. Installez-le avec `npm install gt-sanity`. 2. Ajoutez un champ `language` à chaque type de document à traduire. 3. Enregistrez votre identifiant de projet et la clé API de votre projet dans un document privé `generaltranslation.secrets`. 4. Ajoutez `gtPlugin` à `sanity.config.ts` en indiquant vos paramètres régionaux et vos types de documents : ```ts 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'], translateDocuments: [{ type: 'article' }, { type: 'page' }], }), ], }); ``` 5. Cliquez sur **Translate** dans un document source. ## Ce que fait une exécution de traduction Dans la configuration initiale par défaut, au niveau du document, **Translate** envoie le texte et le Portable Text du document à traduire, laisse intacts les images, les dates, les nombres et les références, puis importe chaque paramètre régional sous forme de brouillon. La publication automatique, la correction des références (qui fait pointer chaque référence vers la traduction dans le même paramètre régional) et **Save local edits** (qui conserve les modifications des éditeurs lorsque le texte source n'a pas changé) sont désactivées par défaut. Votre frontend interroge chaque langue à l'aide d'un filtre GROQ tel que `language == "es"`. Si votre application utilise également General Translation, attribuez le même groupe de contexte aux deux projets afin que les termes soient traduits de façon cohérente. Le [Démarrage rapide Sanity](/docs/integrations/sanity/quickstart) détaille toutes les étapes. ## Related questions - [Comment traduire du contenu dans Storyblok ?](https://generaltranslation.com/fr/kb/translate-storyblok-content.mdx): Dans Storyblok, ajoutez vos langues cibles à l’espace et attribuez à chaque champ traduisible une valeur par langue. L’intégration Storyblok de General Translation remplit ces valeurs depuis le tableau de bord grâce à Synchroniser et appliquer, sous forme de brouillons que vous relisez et publiez dans Storyblok. - [Comment traduire un site de documentation Mintlify ?](https://generaltranslation.com/fr/kb/translate-mintlify-docs.mdx): Rédigez une copie traduite de chaque page dans un dossier par langue, puis ajoutez chaque langue à la navigation de docs.json. Locadex, l’agent IA de General Translation, ouvre une pull request qui ajoute les pages traduites et la navigation propre à chaque langue, puis traduit les modifications ultérieures. - [Comment traduire Google Slides ?](https://generaltranslation.com/fr/kb/translate-google-slides.mdx): Copiez la présentation une fois par langue, remplacez le texte de chaque zone de texte, cellule de tableau et note du présentateur, puis redimensionnez le texte qui déborde. L’intégration Google Drive de General Translation enregistre chaque langue dans sa propre copie, à côté de la source, et effectue une passe de formatage pour ajuster le nouveau texte à chaque diapositive. - [Comment relire et modifier les traductions ?](https://generaltranslation.com/fr/kb/review-translations.mdx): Comparez chaque traduction avec sa source et les autres paramètres régionaux, puis corrigez ce qui sonne faux. Avec General Translation, vous modifiez les traductions sur la page Translations du tableau de bord et suivez la relecture à l’aide d’étiquettes et de commentaires ; la prochaine exécution de traduction de Locadex, son agent IA, intègre ensuite vos modifications dans une pull request. ## Previous and next questions - Previous question: [Comment traduire des chaînes en dehors du JSX ?](https://generaltranslation.com/fr/kb/translate-strings-outside-jsx.mdx) - Next question: [Comment traduire du contenu dans Storyblok ?](https://generaltranslation.com/fr/kb/translate-storyblok-content.mdx) ## Sitemap See the [Knowledge Base sitemap](https://generaltranslation.com/fr/kb/sitemap.md) for every article.