# General Translation Integrations: Contenuti supportati URL: https://generaltranslation.com/it/docs/integrations/mintlify/reference/supported-content.mdx --- title: Contenuti supportati description: Riferimento ai file e ai contenuti che General Translation traduce in un progetto Mintlify. Riferimento ai contenuti supportati da Mintlify. --- # Contenuti supportati Questa pagina indica con precisione cosa General Translation traduce in un progetto Mintlify, cosa lascia invariato e quali file sono sempre esclusi. ## Panoramica [#overview] | Argomento | Descrizione | | --------------------------------------- | ------------------------------------------------------------------------------------------ | | [Contenuti tradotti](#translated) | Le pagine, il frontmatter, gli snippet e gli elementi di navigazione che vengono tradotti. | | [Contenuti preservati](#preserved) | Il codice e la struttura che la traduzione non modifica mai. | | [File esclusi](#excluded) | I file del repository che vengono sempre saltati. | | [Requisiti del progetto](#requirements) | Ciò che rende un repository un progetto Mintlify valido. | ## Contenuti tradotti [#translated] Locadex traduce i contenuti leggibili della tua documentazione. ### Pagine Tutti i file `.mdx` e `.md` corrispondenti ai glob configurati vengono tradotti. La traduzione avviene a livello di sintassi Markdown/MDX, quindi titoli, paragrafi, elenchi, tabelle, callout, link e componenti personalizzati mantengono la propria struttura. General Translation aggiunge anche ID di ancoraggio stabili ai titoli (`experimentalAddHeaderAnchorIds: 'mintlify'`), così i link interni alla pagina continuano a funzionare in tutte le lingue. ### Frontmatter I campi del frontmatter, come il titolo e la descrizione della pagina, vengono tradotti affinché le etichette di navigazione e i metadati SEO funzionino correttamente in ogni lingua. Quando una pagina non ha un titolo esplicito, Mintlify ne ricava uno dal nome del file (`mintlify.inferTitleFromFilename`). ### Frammenti I frammenti riutilizzabili in `snippets/` vengono tradotti e localizzati tramite `docsImportPattern` (`/snippets/[locale]`), quindi il contenuto importato viene mostrato nella lingua del lettore. ### Navigazione `docs.json` viene localizzato con un preset di Mintlify: le etichette di navigazione vengono tradotte e la struttura di navigazione viene riorganizzata nel layout multilingua di Mintlify, con una voce per ogni lingua. Vengono inoltre generati dei redirect, così i link esistenti continuano a essere risolti correttamente. ## Contenuti preservati [#preserved] La traduzione non altera mai i seguenti elementi: * Blocchi di codice, codice inline ed evidenziazione della sintassi. Vengono tradotti solo i commenti e le stringhe di documentazione nel testo. * Componenti MDX personalizzati, link e formattazione. * Struttura dei file: la traduzione non rinomina né riorganizza i componenti o il codice. ## File esclusi [#excluded] Le cartelle delle impostazioni regionali sono escluse, così da evitare che l'output tradotto venga tradotto di nuovo. Inoltre, questi comuni file del repository sono sempre esclusi dalla traduzione: | File | File | | ---------------- | -------------------- | | `README.md` | `HISTORY.md` | | `LICENSE.md` | `CODE_OF_CONDUCT.md` | | `COPYING.md` | `CONTRIBUTING.md` | | `NOTICE.md` | `SECURITY.md` | | `CHANGELOG.md` | `GOVERNANCE.md` | | `AGENTS.md` | `OWNERS.md` | | `MAINTAINERS.md` | | Se il tuo repository contiene contenuti traducibili in uno di questi file, modifica l'elenco `exclude` nella [configurazione](/docs/integrations/mintlify/reference/config) generata dopo la configurazione iniziale. ## Requisiti del progetto [#requirements] General Translation valida il repository prima della configurazione e rifiuta i progetti che non sono siti Mintlify validi: * Il repository deve contenere un file `docs.json` il cui `$schema` punti a Mintlify (`mintlify.com/docs.json`). * I progetti che usano ancora il vecchio `mint.json` vengono rifiutati: esegui prima la migrazione a `docs.json`. * I progetti che sembrano un'app Next.js (ovvero contengono un file `next.config.*`) vengono rifiutati, perché il workflow Mintlify è riservato ai siti di documentazione Mintlify.