# gt: General Translation CLI tool: MDX e Markdown
URL: https://generaltranslation.com/it/docs/cli/reference/formats/mdx-md-files.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Traduci file MDX e Markdown con la CLI di General Translation. Riferimento API per i formati di file MDX e Markdown.

La CLI traduce file MDX (`mdx`) e Markdown (`md`). Tutta la sintassi e la formattazione dei file sorgente vengono preservate nei file tradotti.

## Panoramica [#overview]

| Argomento                                         | Descrizione                                                 |
| ------------------------------------------------- | ----------------------------------------------------------- |
| [Configurazione](#config)                         | Seleziona i file sorgente e i percorsi di output tradotti.  |
| [ID di intestazione personalizzati](#heading-ids) | Preserva gli anchor espliciti delle intestazioni.           |
| [Esportazione di dati statici](#data-exports)     | Riutilizza le stringhe invariate nelle esportazioni idonee. |
| [Nomi dei file tradotti](#transform)              | Rimappa i nomi dei file di output con `transform`.          |
| [Link e risorse](#localize)                       | Localizza URL, importazioni e risorse relative.             |

## Configurazione [#config]

Aggiungi una voce `mdx` o `md` in `files` con un array `include` contenente pattern glob. Usa il segnaposto `[locale]` in modo che la CLI possa trovare i file sorgente e salvare le traduzioni nel percorso corretto.

```json title="gt.config.json"
{
  "defaultLocale": "en",
  "locales": ["ja"],
  "files": {
    "mdx": {
      "include": ["content/docs/[locale]/**/*.mdx"],
      "transform": "*.[locale].mdx"
    }
  }
}
```

In questo modo vengono tradotti tutti i file MDX in `content/docs/en` e i risultati vengono salvati in `content/docs/ja`. Per i file Markdown, usa invece la chiave `md`. Consulta il [riferimento della configurazione](/docs/cli/reference/config#files) per tutte le chiavi relative ai file.

## ID di intestazione personalizzato [#heading-ids]

I suffissi `{#id}` in stile Mintlify restano associati alle rispettive intestazioni dopo la traduzione:

```markdown
## Configura il client {#configure-client}
```

Gli ID espliciti per le intestazioni richiedono `gt` 2.17.3 o versioni successive.

Quando `experimentalAddHeaderAnchorIds` è impostato su `'mintlify'`, la CLI scrive la sintassi nativa di Mintlify `{#id}` su ogni intestazione tradotta e riutilizza l'ID dell'intestazione sorgente. Le intestazioni annidate in JSX vengono spostate a margine quando necessario, perché Mintlify riconosce il suffisso solo sulle intestazioni con un massimo di tre spazi iniziali. Questa modalità richiede `gt` 2.20.4 o versioni successive.

## Aggiorna le esportazioni di dati statici [#data-exports]

Quando un file MDX aggiornato contiene esportazioni di dati statici, General Translation riutilizza le stringhe corrispondenti dalle traduzioni precedenti e traduce solo le stringhe nuove o modificate. Il riutilizzo si applica quando ogni variabile esportata nel blocco contiene solo valori letterali statici di stringa, numero, bigint, booleani o `null`, array e oggetti semplici. I wrapper di asserzione TypeScript sono supportati.

Le esportazioni con spread, identificatori, chiamate di funzione, template literals o JSX, oppure con chiavi di oggetti calcolate, usano il percorso di traduzione standard. L'esecuzione di [`gt translate --force`](/docs/cli/reference/commands/translate) o l'applicazione delle traduzioni del Glossario ignorano anch'esse il riutilizzo incrementale.

## Rinomina i file tradotti [#transform]

La chiave `transform` rimappa i nomi dei file di output. Nell'esempio sopra, `*.[locale].mdx` fa sì che l'estensione tradotta diventi `.ja.mdx`. Usalo quando il framework di documentazione prevede un'impostazione regionale nel nome del file anziché nel percorso della directory.

## Localizza link e risorse [#localize]

Diversi flag sperimentali di [`gt translate`](/docs/cli/reference/commands/translate#experimental) si applicano in modo specifico all'output `md` e `mdx`:

* `--experimental-localize-static-urls` — localizza gli URL nei file tradotti.
* `--experimental-localize-static-imports` — localizza gli import statici nei file tradotti.
* `--experimental-localize-relative-assets` — riscrive gli URL relativi delle immagini nei file tradotti.
* `--experimental-hide-default-locale` — omette l'impostazione regionale predefinita dai percorsi localizzati.

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.