# General Translation Knowledge Base: Come si traduce un sito di documentazione Mintlify? URL: https://generaltranslation.com/it/kb/translate-mintlify-docs.mdx Docs index: https://generaltranslation.com/llms.txt Description: 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. Category: Strumenti per il flusso di lavoro Last updated: 2026-10-21 Authors: Kevin Liu, Kevin Wu Published: 2026-10-21 Tradurre un sito di documentazione Mintlify significa scrivere una copia di ogni pagina in una cartella per ciascuna lingua ed elencare ogni lingua nell'array `languages` della navigazione di `docs.json`. Le pagine alternano testo discorsivo a blocchi di codice, componenti MDX, frontmatter e link: il testo e i campi `title` e `description` vanno tradotti, il codice e i componenti devono restare intatti e i link interni devono puntare alle pagine nella lingua del lettore. Inoltre, ogni modifica a una pagina sorgente rende obsolete le relative traduzioni finché qualcuno non le aggiorna. ## Video The video is narrated in English, with English captions. [How do I translate a Mintlify docs site?](https://caxecubb9c64cezv.public.blob.vercel-storage.com/films/kb-translate-mintlify-docs.mp4) (47 s) General Translation lets you choose languages, and Locadex opens a translation pull request. Authorize the General Translation app on GitHub, choose your docs repository in the Dashboard, create an automation from the Generate translations and push template for Mintlify, run its setup with your languages, and merge the pull request that adds a navigation entry per language and the translated pages. ## Modi per tradurre un sito Mintlify | Approccio | Punti di forza | Cosa resta a carico tuo | | -------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Navigazione `languages` di Mintlify, con traduzione manuale | Crea un selettore della lingua e un albero di pagine per ogni lingua a partire da `docs.json` | Scrivere ogni pagina tradotta nella cartella della relativa lingua, scrivere una navigazione completa per ogni lingua e tenere traccia di quali traduzioni sono diventate obsolete a ogni modifica della sorgente | | Google Translate | Traduce una pagina incollata, senza alcuna configurazione | Traduce ogni passaggio in modo isolato; separare la prosa dal codice e dai componenti, così come scrivere le cartelle e la navigazione, spetta a te | | Uno script basato su un'API di IA (OpenAI API, Claude API) | Si può istruire a tradurre la prosa lasciando intatti blocchi di codice e componenti | Uno script che protegga la sintassi MDX, mantenga coerenti i termini di prodotto tra le pagine, scriva le cartelle e la navigazione e venga rieseguito quando le pagine cambiano | | General Translation (Locadex) | Apre una pull request con le pagine tradotte, la navigazione per ogni lingua e i link localizzati, poi traduce ogni modifica in base al trigger che scegli | Revisionare la pull request di configurazione ed eseguirne il merge, poi revisionare le pull request successive o attivare l'**Auto-merge** | Usa la navigazione di Mintlify con traduzione manuale quando i traduttori gestiscono poche pagine che cambiano raramente; usa Google Translate o uno script occasionale basato su un'API di IA per una traduzione una tantum di un sito piccolo e stabile. Usa General Translation quando la documentazione cambia a ogni rilascio e ogni lingua deve restare al passo. ## Tradurre la documentazione Mintlify con Locadex General Translation traduce la documentazione Mintlify con Locadex, il suo agente IA, disponibile con il piano Starter o con il Piano Enterprise. 1. Nella dashboard, connetti GitHub in **Progetto > Integrations > Catalog**. 2. In **Progetto > Automations**, crea un'automazione a partire da **Generate translations and push**, selezionando **Mintlify** come framework. 3. Fai clic su **Run setup** e scegli le lingue. 4. Esamina la pull request aperta da Locadex ed esegui il merge. La pull request aggiunge un file `gt.config.json`, una voce di navigazione in `docs.json` per ogni lingua e le pagine tradotte, in cui codice e componenti mantengono la propria struttura e i link alle pagine tradotte rimandano sempre alla lingua del lettore. Per Mintlify, la finestra di dialogo **Run setup** include l'opzione **Hide default locale in URL paths**, attiva per impostazione predefinita: le pagine sorgente mantengono i percorsi attuali e ogni lingua tradotta ha una propria cartella di impostazione regionale, ad esempio `/es/...`. Se disattivi l'opzione, anche le pagine sorgente vengono spostate in una cartella di impostazione regionale (le pagine in inglese passano a `/en/...`) e i loro URL cambiano di conseguenza. ## Mantenere le traduzioni aggiornate Da quel momento, Locadex viene eseguito a ogni modifica di una pull request (comportamento predefinito) oppure a ogni push di un commit. Ogni esecuzione applica i gruppi di contesto assegnati al progetto (Glossario e prompt personalizzati), che puoi condividere anche con la tua app, così i nomi dei prodotti restano coerenti in entrambi. Trovi tutti i passaggi nell'[Avvio rapido di Mintlify](/docs/integrations/mintlify/quickstart). ## Related questions - [Cosa fa l'agente Locadex?](https://generaltranslation.com/it/kb/what-is-locadex.mdx): Locadex è l'agente IA di General Translation che internazionalizza il codice e traduce i contenuti nel tuo repository GitHub. Le sue automazioni vengono eseguite all'apertura di una pull request, al push di un commit o quando le avvii tu, e ogni modifica arriva sotto forma di pull request. - [Come si traducono i contenuti in Sanity?](https://generaltranslation.com/it/kb/translate-sanity-content.mdx): 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. - [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 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 revisionano e modificano le traduzioni?](https://generaltranslation.com/it/kb/review-translations.mdx) - Next question: [Come si traduce un'app Node.js?](https://generaltranslation.com/it/kb/translate-node-app.mdx) ## Sitemap See the [Knowledge Base sitemap](https://generaltranslation.com/it/kb/sitemap.md) for every article.