# General Translation Knowledge Base: Come si traducono i contenuti in Sanity? URL: https://generaltranslation.com/it/kb/translate-sanity-content.mdx Docs index: https://generaltranslation.com/llms.txt Description: Salva ogni lingua come documento separato oppure come valore per impostazione regionale in ciascun campo, quindi traduci la sorgente in ogni impostazione regionale di destinazione. Il plugin gt-sanity di General Translation aggiunge un'azione Translate a Sanity Studio e, per impostazione predefinita, importa ogni traduzione come bozza da revisionare e pubblicare. Category: Strumenti per il flusso di lavoro Last updated: 2026-10-21 Authors: Kevin Liu, Kevin Wu Published: 2026-10-21 Per tradurre i contenuti in Sanity, salvi ogni lingua come documento separato contrassegnato da un campo lingua (localizzazione a livello di documento) oppure come valore per impostazione regionale all'interno di ciascun campo (localizzazione a livello di campo), quindi popoli ogni lingua di destinazione a partire dalla sorgente. Non è semplice, perché un documento è costituito da dati strutturati: il Portable Text (il formato di testo ricco di Sanity) deve mantenere blocchi e mark; immagini, date e numeri vanno copiati senza modifiche; con un documento per lingua, ogni riferimento deve puntare alla traduzione corrispondente; infine, le correzioni apportate dai redattori alle traduzioni non devono andare perse con l'aggiornamento successivo. ## 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. ## Modi per tradurre i contenuti di Sanity | Approccio | Punti di forza | Come le traduzioni arrivano in Sanity | Cosa resta a carico tuo | | -------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Solo i plugin di localizzazione di Sanity | Memorizzano ogni lingua come documento separato o come valore per impostazione regionale in ciascun campo | I tuoi redattori o traduttori inseriscono manualmente ogni lingua in Sanity Studio | Ogni traduzione e ogni aggiornamento quando la sorgente cambia | | Google Translate | Traduce il testo che incolli, senza alcuna configurazione | Copia e incolla, oppure uno script che scrive tramite l'API di Sanity | Traduce ogni stringa in modo isolato; suddividere il Portable Text in stringhe e ricostruirlo, copiare gli altri campi, ricollegare i riferimenti, garantire la coerenza terminologica e la revisione restano a carico tuo | | Uno script basato su un'API di AI (OpenAI API, Claude API) | Traduce molti documenti in un'unica esecuzione tramite script, con il tono e la terminologia definiti nel prompt | Uno script che scrive tramite l'API di Sanity | Suddividere e ricostruire il Portable Text, copiare gli altri campi, ricollegare i riferimenti, fornire contesto e terminologia a ogni richiesta e la revisione | | General Translation (`gt-sanity`) | Traduce testo e Portable Text applicando i gruppi di contesto (Glossario e prompt personalizzati) del tuo progetto | Un'azione **Translate** in Studio importa ogni impostazione regionale come bozza | Un campo lingua, un documento di credenziali e una revisione prima della pubblicazione | Usa solo i plugin di localizzazione di Sanity se sono i traduttori a scrivere ogni lingua e i contenuti cambiano di rado; usa Google Translate o uno script basato su un'API di AI per testi occasionali che qualcuno revisiona prima della pubblicazione. Usa General Translation quando i documenti contengono testo ricco e riferimenti e vengono aggiornati di continuo. ## Tradurre documenti con gt-sanity Il plugin `gt-sanity` di General Translation aggiunge l'azione **Translate** a Sanity Studio e supporta entrambi i modelli, con la traduzione a livello di documento come `translationLevel` predefinito. 1. Installalo con `npm install gt-sanity`. 2. Aggiungi un campo `language` a ogni tipo di documento da tradurre. 3. Salva l'ID progetto e la chiave API del progetto in un documento privato `generaltranslation.secrets`. 4. Aggiungi `gtPlugin` a `sanity.config.ts` specificando le impostazioni regionali e i tipi di documento: ```ts title="sanity.config.ts" import { defineConfig } from 'sanity'; import { gtPlugin } from 'gt-sanity'; export default defineConfig({ // ... la tua config esistente plugins: [ gtPlugin({ sourceLocale: 'en', locales: ['es', 'zh', 'ja'], translateDocuments: [{ type: 'article' }, { type: 'page' }], }), ], }); ``` 5. Fai clic su **Translate** in un documento sorgente. ## Cosa fa un'esecuzione di traduzione Nella configurazione predefinita a livello di documento, **Translate** invia in traduzione il testo e il Portable Text del documento, lascia invariati immagini, date, numeri e riferimenti e importa ogni impostazione regionale come bozza. La pubblicazione automatica, la correzione dei riferimenti (che fa puntare ogni riferimento alla traduzione nella stessa impostazione regionale) e **Save local edits** (che conserva le modifiche dei redattori se il testo di origine non è cambiato) sono disattivate per impostazione predefinita. Il frontend interroga ciascuna lingua con un filtro GROQ come `language == "es"`. Se la tua app usa anche General Translation, assegna a entrambi i progetti lo stesso gruppo di contesto, così i termini verranno tradotti in modo coerente. Tutti i passaggi sono descritti nell'[Avvio rapido di Sanity](/docs/integrations/sanity/quickstart). ## Related questions - [Come si traducono i contenuti in Storyblok?](https://generaltranslation.com/it/kb/translate-storyblok-content.mdx): In Storyblok, aggiungi le lingue di destinazione allo spazio e assegna a ogni campo traducibile un valore per ciascuna lingua. L'integrazione Storyblok di General Translation compila questi valori dalla dashboard con Sincronizza e applica, sotto forma di bozze da revisionare e pubblicare in Storyblok. - [Come si traduce un sito di documentazione Mintlify?](https://generaltranslation.com/it/kb/translate-mintlify-docs.mdx): Scrivi una copia tradotta di ogni pagina in una cartella per ciascuna lingua e aggiungi ogni lingua alla navigazione di docs.json. L'agente IA di General Translation, Locadex, apre una pull request che aggiunge le pagine tradotte e la navigazione per ciascuna lingua, e poi traduce le modifiche successive. - [Come si traducono le presentazioni Google Slides?](https://generaltranslation.com/it/kb/translate-google-slides.mdx): Crea una copia della presentazione per ogni lingua, sostituisci il testo in ogni casella di testo, cella di tabella e nota del relatore e ridimensiona il testo che fuoriesce. L'integrazione di General Translation con Google Drive salva ogni lingua in una copia separata accanto alla presentazione sorgente ed esegue un passaggio di formattazione per adattare il nuovo testo a ogni slide. - [Come si revisionano e modificano le traduzioni?](https://generaltranslation.com/it/kb/review-translations.mdx): Confronta ogni traduzione con il testo sorgente e con le altre impostazioni regionali, e correggi ciò che non suona bene. Con General Translation modifichi le traduzioni nella pagina Traduzioni della dashboard e tieni traccia della revisione con etichette e commenti; alla successiva esecuzione della traduzione, Locadex, il suo Agente IA, riporta le modifiche in una pull request. ## Previous and next questions - Previous question: [Come si traduce un'app Vue?](https://generaltranslation.com/it/kb/translate-vue-app.mdx) - Next question: [Come si traducono i contenuti in Storyblok?](https://generaltranslation.com/it/kb/translate-storyblok-content.mdx) ## Sitemap See the [Knowledge Base sitemap](https://generaltranslation.com/it/kb/sitemap.md) for every article.