# gt: General Translation CLI tool: MDX et Markdown
URL: https://generaltranslation.com/fr/docs/cli/reference/formats/mdx-md-files.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Traduisez des fichiers MDX et Markdown avec la CLI de General Translation. Référence API des formats de fichier MDX et Markdown.

La CLI traduit les fichiers MDX (`mdx`) et Markdown (`md`). Toute la syntaxe et la mise en forme des fichiers source sont préservées dans les fichiers traduits.

## Vue d’ensemble [#overview]

| Sujet                                                | Description                                                                       |
| ---------------------------------------------------- | --------------------------------------------------------------------------------- |
| [Configuration](#config)                             | Sélectionnez les fichiers sources et les chemins de sortie des fichiers traduits. |
| [Identifiants de titres personnalisés](#heading-ids) | Préservez les ancres de titres explicites.                                        |
| [Exports de données statiques](#data-exports)        | Réutilisez les chaînes inchangées dans les exports éligibles.                     |
| [Noms de fichiers traduits](#transform)              | Remappez les noms des fichiers de sortie avec `transform`.                        |
| [Liens et ressources](#localize)                     | Localisez les URL, les imports et les ressources relatives.                       |

## Configuration [#config]

Ajoutez une entrée `mdx` ou `md` dans `files`, avec un tableau `include` contenant des motifs glob. Utilisez l’espace réservé `[locale]` pour que le CLI puisse trouver les fichiers source et enregistrer les traductions au bon emplacement.

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

Cela traduit chaque fichier MDX dans `content/docs/en` et enregistre les résultats dans `content/docs/ja`. Utilisez plutôt la clé `md` pour les fichiers Markdown. Consultez la [référence de configuration](/docs/cli/reference/config#files) pour connaître toutes les clés de fichier.

## identifiants de titre personnalisés [#heading-ids]

Les suffixes `{#id}` de style Mintlify restent rattachés à leurs titres après la traduction :

```markdown
## Configurer le client {#configure-client}
```

Les identifiants de titres explicites nécessitent `gt` 2.17.3 ou une version ultérieure.

Lorsque `experimentalAddHeaderAnchorIds` est défini sur `'mintlify'`, la CLI écrit la syntaxe `{#id}` native de Mintlify sur chaque titre traduit et réutilise l'identifiant du titre source. Les titres imbriqués dans du JSX sont déplacés dans la marge lorsque c'est nécessaire, car Mintlify ne reconnaît le suffixe que sur les titres précédés d'au plus trois espaces. Ce mode nécessite `gt` 2.20.4 ou une version ultérieure.

## Mettre à jour les exports de données statiques [#data-exports]

Lorsqu’un fichier MDX mis à jour contient des exports de données statiques, General Translation réutilise les chaînes correspondantes issues de traductions antérieures et ne traduit que les chaînes nouvelles ou modifiées. Cette réutilisation s’applique lorsque chaque variable exportée du segment ne contient que des littéraux statiques de type chaîne, nombre, bigint, booléen ou `null`, des tableaux et des objets simples. Les encapsulations d’assertion TypeScript sont prises en charge.

Les exports qui utilisent des spreads, des identifiants, des appels de fonction, des littéraux de gabarit, du JSX ou des clés d’objet calculées suivent le flux de traduction standard. L’exécution de [`gt translate --force`](/docs/cli/reference/commands/translate) ou l’application de traductions du glossaire n’utilise pas non plus cette réutilisation incrémentielle.

## Renommer les fichiers traduits [#transform]

La clé `transform` remappe les noms des fichiers de sortie. Dans l’exemple ci-dessus, `*.[locale].mdx` transforme l’extension des fichiers traduits en `.ja.mdx`. Utilisez cette option lorsque votre framework de documentation attend un paramètre régional dans le nom du fichier plutôt que dans le chemin du répertoire.

## Localiser les liens et les ressources [#localize]

Plusieurs options expérimentales de [`gt translate`](/docs/cli/reference/commands/translate#experimental) s’appliquent spécifiquement à la sortie `md` et `mdx` :

* `--experimental-localize-static-urls` — localise les URL dans les fichiers traduits.
* `--experimental-localize-static-imports` — localise les imports statiques dans les fichiers traduits.
* `--experimental-localize-relative-assets` — réécrit les URL relatives des ressources image dans les fichiers traduits.
* `--experimental-hide-default-locale` — masque le paramètre régional par défaut dans les chemins localisés.

## Sitemap

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