> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify-docs-automation-github-pr-review.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Structure du site

> Configurez la barre de navigation, le pied de page, la bannière, les redirections et d'autres paramètres structurels dans docs.json.

Utilisez ces paramètres dans votre fichier `docs.json` pour contrôler l'architecture de l'information et l'expérience utilisateur de votre site. Modifiez la barre de navigation, le pied de page, les bannières, le comportement de navigation, les menus contextuels, les redirections et les variables de contenu globales.

## Paramètres

### `navigation` - <Badge color="red">required</Badge>

**Type :** `object`

La structure de navigation de votre contenu. C'est ici que vous définissez la hiérarchie complète des pages de votre site en utilisant des groupes, des onglets, des menus déroulants, des ancres et plus encore.

Voir [Navigation](/fr/organize/navigation) pour la documentation complète sur la construction de votre structure de navigation.

<ResponseField name="navigation.global" type="object">
  Éléments de navigation globaux qui apparaissent sur toutes les pages et locales.

  <Expandable title="navigation.global">
    <ResponseField name="tabs" type="array of object">
      Onglets de navigation de niveau supérieur pour organiser les sections principales. Voir [Onglets](/fr/organize/navigation#tabs).

      <Expandable title="tabs">
        <ResponseField name="tab" type="string" required>
          Nom affiché de l'onglet. Longueur minimale : 1.
        </ResponseField>

        <ResponseField name="icon" type="string">
          L’icône à afficher.

          Options:

          * [Font Awesome](https://fontawesome.com/icons) nom d’icône, si vous avez la propriété `icons.library` [paramètres](/fr/organize/settings#param-icons) définie sur `fontawesome` dans votre `docs.json`
          * [Lucide](https://lucide.dev/icons) nom d’icône, si vous avez la propriété `icons.library` [paramètres](/fr/organize/settings#param-icons) définie sur `lucide` dans votre `docs.json`
          * [Tabler](https://tabler.io/icons) nom d’icône, si vous avez la propriété `icons.library` [paramètres](/fr/organize/settings#param-icons) définie sur `tabler` dans votre `docs.json`
          * URL vers une icône hébergée en externe
          * Chemin vers un fichier d’icône dans votre projet
          * Code SVG entouré d’accolades

          Pour les icônes SVG personnalisées:

          1. Convertissez votre SVG avec le [convertisseur SVGR](https://react-svgr.com/playground/).
          2. Collez votre code SVG dans le champ d’entrée SVG.
          3. Copiez l’élément complet `<svg>...</svg>` depuis le champ de sortie JSX.
          4. Enveloppez le code SVG compatible JSX dans des accolades : `icon={<svg ...> ... </svg>}`.
          5. Ajustez `height` et `width` selon vos besoins.
        </ResponseField>

        <ResponseField name="iconType" type="string">
          Le style d’icône [Font Awesome](https://fontawesome.com/icons). Utilisé uniquement avec les icônes Font Awesome.

          Options: `regular`, `solid`, `light`, `thin`, `sharp-solid`, `duotone`, `brands`.
        </ResponseField>

        <ResponseField name="hidden" type="boolean">
          Indique s'il faut masquer cet onglet par défaut.
        </ResponseField>

        <ResponseField name="href" type="string (uri)" required>
          URL ou chemin de destination de l'onglet.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="anchors" type="array of object">
      Liens d'ancrage qui apparaissent en évidence dans la barre latérale. Voir [Ancres](/fr/organize/navigation#anchors).

      <Expandable title="anchors">
        <ResponseField name="anchor" type="string" required>
          Nom affiché de l'ancre. Longueur minimale : 1.
        </ResponseField>

        <ResponseField name="icon" type="string">
          L’icône à afficher.

          Options:

          * [Font Awesome](https://fontawesome.com/icons) nom d’icône, si vous avez la propriété `icons.library` [paramètres](/fr/organize/settings#param-icons) définie sur `fontawesome` dans votre `docs.json`
          * [Lucide](https://lucide.dev/icons) nom d’icône, si vous avez la propriété `icons.library` [paramètres](/fr/organize/settings#param-icons) définie sur `lucide` dans votre `docs.json`
          * [Tabler](https://tabler.io/icons) nom d’icône, si vous avez la propriété `icons.library` [paramètres](/fr/organize/settings#param-icons) définie sur `tabler` dans votre `docs.json`
          * URL vers une icône hébergée en externe
          * Chemin vers un fichier d’icône dans votre projet
          * Code SVG entouré d’accolades

          Pour les icônes SVG personnalisées:

          1. Convertissez votre SVG avec le [convertisseur SVGR](https://react-svgr.com/playground/).
          2. Collez votre code SVG dans le champ d’entrée SVG.
          3. Copiez l’élément complet `<svg>...</svg>` depuis le champ de sortie JSX.
          4. Enveloppez le code SVG compatible JSX dans des accolades : `icon={<svg ...> ... </svg>}`.
          5. Ajustez `height` et `width` selon vos besoins.
        </ResponseField>

        <ResponseField name="iconType" type="string">
          Le style d’icône [Font Awesome](https://fontawesome.com/icons). Utilisé uniquement avec les icônes Font Awesome.

          Options: `regular`, `solid`, `light`, `thin`, `sharp-solid`, `duotone`, `brands`.
        </ResponseField>

        <ResponseField name="color" type="object">
          Couleurs personnalisées pour l'icône de l'ancre.

          <Expandable title="color">
            <ResponseField name="light" type="string">
              Couleur de l'ancre pour le mode clair. Doit être un code hexadécimal commençant par `#`.
            </ResponseField>

            <ResponseField name="dark" type="string">
              Couleur de l'ancre pour le mode sombre. Doit être un code hexadécimal commençant par `#`.
            </ResponseField>
          </Expandable>
        </ResponseField>

        <ResponseField name="hidden" type="boolean">
          Indique s'il faut masquer cette ancre par défaut.
        </ResponseField>

        <ResponseField name="href" type="string (uri)" required>
          URL ou chemin de destination de l'ancre.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="dropdowns" type="array of object">
      Menus déroulants pour organiser le contenu connexe. Voir [Menus déroulants](/fr/organize/navigation#dropdowns).

      <Expandable title="dropdowns">
        <ResponseField name="dropdown" type="string" required>
          Nom affiché du menu déroulant. Longueur minimale : 1.
        </ResponseField>

        <ResponseField name="icon" type="string">
          L’icône à afficher.

          Options:

          * [Font Awesome](https://fontawesome.com/icons) nom d’icône, si vous avez la propriété `icons.library` [paramètres](/fr/organize/settings#param-icons) définie sur `fontawesome` dans votre `docs.json`
          * [Lucide](https://lucide.dev/icons) nom d’icône, si vous avez la propriété `icons.library` [paramètres](/fr/organize/settings#param-icons) définie sur `lucide` dans votre `docs.json`
          * [Tabler](https://tabler.io/icons) nom d’icône, si vous avez la propriété `icons.library` [paramètres](/fr/organize/settings#param-icons) définie sur `tabler` dans votre `docs.json`
          * URL vers une icône hébergée en externe
          * Chemin vers un fichier d’icône dans votre projet
          * Code SVG entouré d’accolades

          Pour les icônes SVG personnalisées:

          1. Convertissez votre SVG avec le [convertisseur SVGR](https://react-svgr.com/playground/).
          2. Collez votre code SVG dans le champ d’entrée SVG.
          3. Copiez l’élément complet `<svg>...</svg>` depuis le champ de sortie JSX.
          4. Enveloppez le code SVG compatible JSX dans des accolades : `icon={<svg ...> ... </svg>}`.
          5. Ajustez `height` et `width` selon vos besoins.
        </ResponseField>

        <ResponseField name="iconType" type="string">
          Le style d’icône [Font Awesome](https://fontawesome.com/icons). Utilisé uniquement avec les icônes Font Awesome.

          Options: `regular`, `solid`, `light`, `thin`, `sharp-solid`, `duotone`, `brands`.
        </ResponseField>

        <ResponseField name="hidden" type="boolean">
          Indique s'il faut masquer ce menu déroulant par défaut.
        </ResponseField>

        <ResponseField name="href" type="string (uri)" required>
          URL ou chemin de destination du menu déroulant.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="languages" type="array of object">
      Configuration du sélecteur de langue pour les sites localisés. Voir [Langues](/fr/organize/navigation#languages).

      <Expandable title="languages">
        <ResponseField name="language" type="&#x22;ar&#x22; | &#x22;ca&#x22; | &#x22;cn&#x22; | &#x22;cs&#x22; | &#x22;de&#x22; | &#x22;en&#x22; | &#x22;es&#x22; | &#x22;fi&#x22; | &#x22;fr&#x22; | &#x22;fr-CA&#x22; | &#x22;he&#x22; | &#x22;hi&#x22; | &#x22;hu&#x22; | &#x22;id&#x22; | &#x22;it&#x22; | &#x22;ja&#x22; | &#x22;jp&#x22; | &#x22;ko&#x22; | &#x22;lv&#x22; | &#x22;nl&#x22; | &#x22;no&#x22; | &#x22;pl&#x22; | &#x22;pt&#x22; | &#x22;pt-BR&#x22; | &#x22;ro&#x22; | &#x22;ru&#x22; | &#x22;sv&#x22; | &#x22;tr&#x22; | &#x22;uk&#x22; | &#x22;uz&#x22; | &#x22;vi&#x22; | &#x22;zh&#x22; | &#x22;zh-Hans&#x22; | &#x22;zh-Hant&#x22;" required>
          Code de langue au format [ISO 639-1](https://en.wikipedia.org/wiki/ISO_639-1).
        </ResponseField>

        <ResponseField name="default" type="boolean">
          Indique s'il s'agit de la langue par défaut.
        </ResponseField>

        <ResponseField name="hidden" type="boolean">
          Indique s'il faut masquer cette option de langue par défaut.
        </ResponseField>

        <ResponseField name="href" type="string (uri)" required>
          Un chemin ou un lien externe valide vers cette version linguistique de votre documentation.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="versions" type="array of object">
      Configuration du sélecteur de versions pour les sites multi-versions. Voir [Versions](/fr/organize/navigation#versions).

      <Expandable title="versions">
        <ResponseField name="version" type="string" required>
          Nom affiché de la version. Longueur minimale : 1.
        </ResponseField>

        <ResponseField name="default" type="boolean">
          Indique s'il s'agit de la version par défaut.
        </ResponseField>

        <ResponseField name="hidden" type="boolean">
          Indique s'il faut masquer cette version par défaut.
        </ResponseField>

        <ResponseField name="href" type="string (uri)" required>
          URL ou chemin vers cette version de votre documentation.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="products" type="array of object">
      Sélecteur de produits pour les sites avec plusieurs produits. Voir [Produits](/fr/organize/navigation#products).

      <Expandable title="products">
        <ResponseField name="product" type="string" required>
          Nom affiché du produit.
        </ResponseField>

        <ResponseField name="description" type="string">
          Description du produit.
        </ResponseField>

        <ResponseField name="icon" type="string">
          L’icône à afficher.

          Options:

          * [Font Awesome](https://fontawesome.com/icons) nom d’icône, si vous avez la propriété `icons.library` [paramètres](/fr/organize/settings#param-icons) définie sur `fontawesome` dans votre `docs.json`
          * [Lucide](https://lucide.dev/icons) nom d’icône, si vous avez la propriété `icons.library` [paramètres](/fr/organize/settings#param-icons) définie sur `lucide` dans votre `docs.json`
          * [Tabler](https://tabler.io/icons) nom d’icône, si vous avez la propriété `icons.library` [paramètres](/fr/organize/settings#param-icons) définie sur `tabler` dans votre `docs.json`
          * URL vers une icône hébergée en externe
          * Chemin vers un fichier d’icône dans votre projet
          * Code SVG entouré d’accolades

          Pour les icônes SVG personnalisées:

          1. Convertissez votre SVG avec le [convertisseur SVGR](https://react-svgr.com/playground/).
          2. Collez votre code SVG dans le champ d’entrée SVG.
          3. Copiez l’élément complet `<svg>...</svg>` depuis le champ de sortie JSX.
          4. Enveloppez le code SVG compatible JSX dans des accolades : `icon={<svg ...> ... </svg>}`.
          5. Ajustez `height` et `width` selon vos besoins.
        </ResponseField>

        <ResponseField name="iconType" type="string">
          Le style d’icône [Font Awesome](https://fontawesome.com/icons). Utilisé uniquement avec les icônes Font Awesome.

          Options: `regular`, `solid`, `light`, `thin`, `sharp-solid`, `duotone`, `brands`.
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="navigation.languages" type="array of object">
  Sélecteur de langue pour les sites [multilingues](/fr/organize/navigation#languages). Chaque entrée peut inclure des configurations `banner`, `footer` et `navbar` spécifiques à la langue, en plus de la structure de navigation.

  <Expandable title="navigation.languages">
    <ResponseField name="language" type="&#x22;ar&#x22; | &#x22;ca&#x22; | &#x22;cn&#x22; | &#x22;cs&#x22; | &#x22;de&#x22; | &#x22;en&#x22; | &#x22;es&#x22; | &#x22;fi&#x22; | &#x22;fr&#x22; | &#x22;fr-CA&#x22; | &#x22;he&#x22; | &#x22;hi&#x22; | &#x22;hu&#x22; | &#x22;id&#x22; | &#x22;it&#x22; | &#x22;ja&#x22; | &#x22;jp&#x22; | &#x22;ko&#x22; | &#x22;lv&#x22; | &#x22;nl&#x22; | &#x22;no&#x22; | &#x22;pl&#x22; | &#x22;pt&#x22; | &#x22;pt-BR&#x22; | &#x22;ro&#x22; | &#x22;ru&#x22; | &#x22;sv&#x22; | &#x22;tr&#x22; | &#x22;uk&#x22; | &#x22;uz&#x22; | &#x22;vi&#x22; | &#x22;zh&#x22; | &#x22;zh-Hans&#x22; | &#x22;zh-Hant&#x22;" required>
      Code de langue au format [ISO 639-1](https://en.wikipedia.org/wiki/ISO_639-1).
    </ResponseField>

    <ResponseField name="default" type="boolean">
      Indique s'il s'agit de la langue par défaut.
    </ResponseField>

    <ResponseField name="banner" type="object">
      Configuration de bannière spécifique à la langue. Accepte les mêmes options que le champ [`banner`](#banner) de niveau supérieur.
    </ResponseField>

    <ResponseField name="footer" type="object">
      Configuration de pied de page spécifique à la langue. Accepte les mêmes options que le champ [`footer`](#footer) de niveau supérieur.
    </ResponseField>

    <ResponseField name="navbar" type="object">
      Configuration de barre de navigation spécifique à la langue. Accepte les mêmes options que le champ [`navbar`](#navbar) de niveau supérieur.
    </ResponseField>

    <ResponseField name="hidden" type="boolean">
      Indique s'il faut masquer cette option de langue par défaut.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="navigation.versions" type="array of object">
  Sélecteur de versions pour les sites avec [plusieurs versions](/fr/organize/navigation#versions).

  <Expandable title="navigation.versions">
    <ResponseField name="default" type="boolean">
      Définissez sur `true` pour faire de cette version la version par défaut. Si omis, la première version du tableau est la version par défaut.
    </ResponseField>

    <ResponseField name="tag" type="string">
      Libellé du badge affiché à côté de la version dans le sélecteur. Utilisez pour mettre en évidence des versions comme `"Latest"`, `"Recommended"` ou `"Beta"`.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="navigation.tabs" type="array of object">
  [Onglets](/fr/organize/navigation#tabs) de navigation de niveau supérieur.
</ResponseField>

<ResponseField name="navigation.anchors" type="array of object">
  [Ancres](/fr/organize/navigation#anchors) de la barre latérale.
</ResponseField>

<ResponseField name="navigation.dropdowns" type="array of object">
  [Menus déroulants](/fr/organize/navigation#dropdowns) pour regrouper le contenu connexe.
</ResponseField>

<ResponseField name="navigation.products" type="array of object">
  Sélecteur de produits pour les sites avec plusieurs [produits](/fr/organize/navigation#products).
</ResponseField>

<ResponseField name="navigation.groups" type="array of object">
  [Groupes](/fr/organize/navigation#groups) pour organiser le contenu en sections.
</ResponseField>

<ResponseField name="navigation.pages" type="array of string or object">
  [Pages](/fr/organize/navigation#pages) individuelles qui composent votre documentation.
</ResponseField>

<ResponseField name="navigation.directory" type="&#x22;none&#x22; | &#x22;accordion&#x22; | &#x22;card&#x22;">
  Disposition de répertoire pour les pages racines dans les groupes de navigation. Lorsqu'il est défini, les groupes avec une page `root` affichent automatiquement une liste de leurs pages enfants sous le contenu de la page. Les valeurs s'héritent récursivement à travers l'arbre de navigation. Les descendants peuvent les remplacer. Voir [Listes de répertoire](/fr/organize/navigation#directory-listings).
</ResponseField>

***

### `navbar`

**Type :** `object`

Liens et boutons affichés dans la barre de navigation supérieure.

<ResponseField name="navbar.links" type="array of object">
  Liens à afficher dans la barre de navigation.

  <Expandable title="navbar.links">
    <ResponseField name="type" type="&#x22;github&#x22; | &#x22;discord&#x22;">
      Type de lien facultatif. Omettez pour un lien textuel standard. Définissez sur `github` pour créer un lien vers un dépôt GitHub et afficher son nombre d'étoiles. Définissez sur `discord` pour créer un lien vers un serveur Discord et afficher le nombre d'utilisateurs en ligne.
    </ResponseField>

    <ResponseField name="label" type="string">
      Texte du lien. Requis lorsque `type` n'est pas défini. Facultatif pour `github` et `discord`. Si omis, Mintlify génère le libellé à partir des données de l'API.
    </ResponseField>

    <ResponseField name="href" type="string (uri)" required>
      Destination du lien. Doit être une URL externe valide. Pour `github`, doit être une URL de dépôt GitHub. Pour `discord`, doit être une URL d'invitation Discord.
    </ResponseField>

    <ResponseField name="icon" type="string">
      L’icône à afficher.

      Options:

      * [Font Awesome](https://fontawesome.com/icons) nom d’icône, si vous avez la propriété `icons.library` [paramètres](/fr/organize/settings#param-icons) définie sur `fontawesome` dans votre `docs.json`
      * [Lucide](https://lucide.dev/icons) nom d’icône, si vous avez la propriété `icons.library` [paramètres](/fr/organize/settings#param-icons) définie sur `lucide` dans votre `docs.json`
      * [Tabler](https://tabler.io/icons) nom d’icône, si vous avez la propriété `icons.library` [paramètres](/fr/organize/settings#param-icons) définie sur `tabler` dans votre `docs.json`
      * URL vers une icône hébergée en externe
      * Chemin vers un fichier d’icône dans votre projet
      * Code SVG entouré d’accolades

      Pour les icônes SVG personnalisées:

      1. Convertissez votre SVG avec le [convertisseur SVGR](https://react-svgr.com/playground/).
      2. Collez votre code SVG dans le champ d’entrée SVG.
      3. Copiez l’élément complet `<svg>...</svg>` depuis le champ de sortie JSX.
      4. Enveloppez le code SVG compatible JSX dans des accolades : `icon={<svg ...> ... </svg>}`.
      5. Ajustez `height` et `width` selon vos besoins.
    </ResponseField>

    <ResponseField name="iconType" type="string">
      Le style d’icône [Font Awesome](https://fontawesome.com/icons). Utilisé uniquement avec les icônes Font Awesome.

      Options: `regular`, `solid`, `light`, `thin`, `sharp-solid`, `duotone`, `brands`.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="navbar.primary" type="object">
  Bouton d'appel à l'action principal dans la barre de navigation.

  <Expandable title="navbar.primary">
    <ResponseField name="type" type="&#x22;button&#x22; | &#x22;github&#x22; | &#x22;discord&#x22;" required>
      Style du bouton. Choisissez `button` pour un bouton standard, `github` pour un lien vers un dépôt GitHub avec nombre d'étoiles, ou `discord` pour une invitation Discord avec nombre d'utilisateurs en ligne.
    </ResponseField>

    <ResponseField name="label" type="string">
      Texte du bouton. Requis lorsque `type` est `button`. Facultatif pour `github` et `discord`.
    </ResponseField>

    <ResponseField name="href" type="string (uri)" required>
      Destination du bouton. Doit être une URL externe. Pour `github`, doit être une URL de dépôt GitHub. Pour `discord`, doit être une URL d'invitation Discord.
    </ResponseField>
  </Expandable>
</ResponseField>

```json docs.json theme={null}
"navbar": {
  "links": [
    { "type": "github", "href": "https://github.com/your-org/your-repo" },
    { "label": "Communauté", "href": "https://example.com/community" }
  ],
  "primary": {
    "type": "button",
    "label": "Commencer",
    "href": "https://example.com/signup"
  }
}
```

***

### `footer`

**Type :** `object`

Contenu du pied de page et liens vers les réseaux sociaux.

<ResponseField name="footer.socials" type="object">
  Profils de réseaux sociaux à afficher dans le pied de page. Chaque clé est un nom de plateforme et chaque valeur est l'URL de votre profil.

  Clés valides : `x`, `website`, `facebook`, `youtube`, `discord`, `slack`, `github`, `linkedin`, `instagram`, `hacker-news`, `medium`, `telegram`, `twitter`, `x-twitter`, `earth-americas`, `bluesky`, `threads`, `reddit`, `podcast`

  ```json theme={null}
  "socials": {
    "x": "https://x.com/yourhandle",
    "github": "https://github.com/your-org"
  }
  ```
</ResponseField>

<ResponseField name="footer.links" type="array of object">
  Colonnes de liens affichées dans le pied de page. Maximum 4 colonnes.

  <Expandable title="footer.links">
    <ResponseField name="header" type="string">
      Titre de l'en-tête de colonne. Longueur minimale : 1.
    </ResponseField>

    <ResponseField name="items" type="array of object" required>
      Liens à afficher dans la colonne.

      <Expandable title="items">
        <ResponseField name="label" type="string" required>
          Texte du lien. Longueur minimale : 1.
        </ResponseField>

        <ResponseField name="href" type="string (uri)" required>
          URL de destination du lien.
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

```json docs.json theme={null}
"footer": {
  "socials": {
    "x": "https://x.com/yourhandle",
    "github": "https://github.com/your-org"
  },
  "links": [
    {
      "header": "Entreprise",
      "items": [
        { "label": "Blog", "href": "https://example.com/blog" },
        { "label": "Carrières", "href": "https://example.com/careers" }
      ]
    }
  ]
}
```

***

### `banner`

**Type :** `object`

Une bannière globale affichée en haut de chaque page.

<ResponseField name="banner.content" type="string" required>
  Le contenu textuel affiché dans la bannière. Prend en charge le formatage MDX de base, y compris les liens, le texte en gras et en italique. Les composants personnalisés ne sont pas pris en charge.

  ```json theme={null}
  "content": "Nous venons de lancer quelque chose de nouveau. [En savoir plus](https://example.com)"
  ```
</ResponseField>

<ResponseField name="banner.dismissible" type="boolean">
  Indique s'il faut afficher un bouton de fermeture pour que les utilisateurs puissent fermer la bannière. Valeur par défaut : `false`.
</ResponseField>

```json docs.json theme={null}
"banner": {
  "content": "Nous venons de lancer quelque chose de nouveau. [En savoir plus](https://example.com)",
  "dismissible": true
}
```

***

### `interaction`

**Type :** `object`

Contrôle le comportement d'interaction utilisateur pour les éléments de navigation.

<ResponseField name="interaction.drilldown" type="boolean">
  Contrôle la navigation automatique lors de la sélection d'un groupe de navigation. Définissez sur `true` pour naviguer automatiquement vers la première page lorsqu'un groupe se développe. Définissez sur `false` pour uniquement développer ou réduire le groupe sans naviguer. Laissez non défini pour utiliser le comportement par défaut du thème.
</ResponseField>

***

### `contextual`

**Type :** `object`

Le menu contextuel donne aux utilisateurs un accès rapide aux outils IA et aux actions de page. Il apparaît dans l'en-tête de la page ou dans la barre latérale de la table des matières.

<Note>
  Le menu contextuel est uniquement disponible sur les déploiements de prévisualisation et de production.
</Note>

<ResponseField name="contextual.options" type="array" required>
  Actions disponibles dans le menu contextuel. La première option du tableau apparaît comme action par défaut.

  Options intégrées :

  * `"add-mcp"`—Ajouter votre serveur MCP à la configuration de l'utilisateur
  * `"aistudio"`—Envoyer la page actuelle à Google AI Studio
  * `"assistant"`—Ouvrir l'assistant IA avec la page actuelle comme contexte
  * `"copy"`—Copier la page actuelle au format Markdown dans le presse-papiers
  * `"chatgpt"`—Envoyer la page actuelle à ChatGPT
  * `"claude"`—Envoyer la page actuelle à Claude
  * `"cursor"`—Installer votre serveur MCP hébergé dans Cursor
  * `"devin"`—Envoyer la page actuelle à Devin
  * `"devin-mcp"`—Installer votre serveur MCP hébergé dans Devin
  * `"download-pdf"`—Télécharger la page actuelle au format PDF
  * `"download-spec"`—Télécharger les spécifications OpenAPI du déploiement (un seul fichier, ou compressées en zip s'il y en a plusieurs)
  * `"grok"`—Envoyer la page actuelle à Grok
  * `"mcp"`—Copier l'URL de votre serveur MCP dans le presse-papiers
  * `"perplexity"`—Envoyer la page actuelle à Perplexity
  * `"view"`—Afficher la page actuelle au format Markdown dans un nouvel onglet
  * `"vscode"`—Installer votre serveur MCP hébergé dans VS Code
  * `"devin-desktop"`—Ouvrir Devin Desktop avec la page actuelle comme contexte

  Définissez des options personnalisées sous forme d'objets :

  <Expandable title="Option personnalisée">
    <ResponseField name="title" type="string" required>
      Titre affiché pour l'option personnalisée.
    </ResponseField>

    <ResponseField name="description" type="string" required>
      Texte descriptif pour l'option personnalisée.
    </ResponseField>

    <ResponseField name="icon" type="string">
      Icône pour l'option personnalisée. Prend en charge les noms de bibliothèque d'icônes, les URL, les chemins ou le code SVG.
    </ResponseField>

    <ResponseField name="href" type="string or object" required>
      Destination du lien. Peut être une chaîne URL ou un objet avec `base` et des paramètres `query` facultatifs.

      Valeurs de substitution disponibles :

      * `$page`—Contenu de la page actuelle
      * `$path`—Chemin de la page actuelle
      * `$mcp`—URL du serveur MCP
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="contextual.display" type="&#x22;header&#x22; | &#x22;toc&#x22;">
  Où afficher les options contextuelles. Choisissez `header` pour les afficher dans le menu contextuel en haut de la page, ou `toc` pour les afficher dans la barre latérale de la table des matières. Valeur par défaut : `header`.
</ResponseField>

```json docs.json theme={null}
"contextual": {
  "options": ["copy", "view", "chatgpt", "claude"],
  "display": "header"
}
```

***

### `redirects`

**Type :** `array of object`

Redirections pour les pages déplacées, renommées ou supprimées. Utilisez-les pour préserver les liens lorsque vous réorganisez votre contenu.

<ResponseField name="redirects[].source" type="string" required>
  Le chemin source à partir duquel rediriger. Exemple : `/old-page`
</ResponseField>

<ResponseField name="redirects[].destination" type="string" required>
  Le chemin de destination vers lequel rediriger. Exemple : `/new-page`
</ResponseField>

<ResponseField name="redirects[].permanent" type="boolean">
  Si `true`, émet une redirection permanente (308). Si `false`, émet une redirection temporaire (307). Valeur par défaut : `true`.
</ResponseField>

```json docs.json theme={null}
"redirects": [
  {
    "source": "/old-page",
    "destination": "/new-page"
  },
  {
    "source": "/temp-redirect",
    "destination": "/destination",
    "permanent": false
  }
]
```

***

### `errors`

**Type :** `object`

Paramètres personnalisés de la page d'erreur.

<ResponseField name="errors.404" type="object">
  Paramètres pour la page d'erreur 404 « Page non trouvée ».

  <Expandable title="errors.404">
    <ResponseField name="redirect" type="boolean">
      Indique s'il faut rediriger automatiquement vers la page d'accueil lorsqu'une page n'est pas trouvée. Valeur par défaut : `true`.
    </ResponseField>

    <ResponseField name="title" type="string">
      Titre personnalisé pour la page 404.
    </ResponseField>

    <ResponseField name="description" type="string">
      Description personnalisée pour la page 404. Prend en charge le formatage MDX, y compris les liens, le texte en gras et en italique, et les composants personnalisés.
    </ResponseField>
  </Expandable>
</ResponseField>

```json docs.json theme={null}
"errors": {
  "404": {
    "redirect": false,
    "title": "Page non trouvée",
    "description": "La page que vous recherchez n'existe pas. [Retour à l'accueil](/)."
  }
}
```

***

### `variables`

**Type :** `object`

Variables globales à utiliser dans toute votre documentation. Mintlify remplace les espaces réservés `{{variableName}}` par les valeurs définies au moment de la compilation.

<ResponseField name="variables.[variableName]" type="string">
  Une paire clé-valeur où la clé est le nom de la variable et la valeur est le texte de remplacement.

  * Les noms de variables peuvent contenir des caractères alphanumériques et des tirets.
  * Vous devez définir toutes les variables référencées dans votre contenu, sinon la compilation échoue.
  * Mintlify assainit les valeurs pour prévenir les attaques XSS.
</ResponseField>

```json docs.json theme={null}
"variables": {
  "version": "2.0.0",
  "api-url": "https://api.example.com"
}
```

Dans votre contenu, référencez les variables avec des doubles accolades :

```mdx theme={null}
La version actuelle est {{version}}. Envoyez des requêtes à {{api-url}}.
```

***

### `metadata`

**Type :** `object`

Paramètres de métadonnées au niveau de la page appliqués globalement.

<ResponseField name="metadata.timestamp" type="boolean">
  Active une date de dernière modification sur toutes les pages. Lorsqu'elle est activée, les pages affichent la date de la dernière modification du contenu. Valeur par défaut : `false`.

  Vous pouvez remplacer ce paramètre sur des pages individuelles en utilisant le champ frontmatter `timestamp`. Voir [Pages](/fr/organize/pages#last-modified-timestamp) pour plus de détails.
</ResponseField>

```json docs.json theme={null}
"metadata": {
  "timestamp": true
}
```