> ## Documentation Index
> Fetch the complete documentation index at: https://omer-914cc1c6.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation de l’interface en ligne de commande (CLI)

> Installez la CLI pour prévisualiser et développer votre documentation en local

<img className="block dark:hidden my-0 pointer-events-none" src="https://mintcdn.com/omer-914cc1c6/1pfjDJXEL6HIHDKE/images/installation/local-development-light.png?fit=max&auto=format&n=1pfjDJXEL6HIHDKE&q=85&s=6525a601adf38652082acfa170797829" width="1184" height="320" data-path="images/installation/local-development-light.png" />

<img className="hidden dark:block my-0 pointer-events-none" src="https://mintcdn.com/omer-914cc1c6/1pfjDJXEL6HIHDKE/images/installation/local-development-dark.png?fit=max&auto=format&n=1pfjDJXEL6HIHDKE&q=85&s=c3239d807129b6f835400e3d926d964c" width="1184" height="320" data-path="images/installation/local-development-dark.png" />

<div id="installing-the-cli">
  ## Installation de l’interface en ligne de commande (CLI)
</div>

<Info>
  **Prérequis** : installez [Node.js](https://nodejs.org/en) avant de continuer.
</Info>

<Steps>
  <Step title="Installer la CLI.">
    Exécutez la commande suivante pour installer la [CLI](https://www.npmjs.com/package/mint) :

    <CodeGroup>
      ```bash npm theme={null}
      npm i -g mint
      ```

      ```bash pnpm theme={null}
      pnpm add -g mint
      ```
    </CodeGroup>
  </Step>

  <Step title="Aperçu en local.">
    Accédez à votre dossier de documentation (là où se trouve votre fichier `docs.json`) et exécutez la commande suivante :

    ```bash theme={null}
    mint dev
    ```

    Un aperçu local de votre documentation sera disponible à l’adresse `http://localhost:3000`.
  </Step>
</Steps>

Sinon, si vous ne souhaitez pas installer la CLI globalement, vous pouvez exécuter un script ponctuel :

```bash theme={null}
npx mint dev
```

<div id="updates">
  ## Mises à jour
</div>

Si votre aperçu local n’est pas en phase avec ce que vous voyez en ligne dans la version de production, mettez à jour votre interface en ligne de commande (CLI) locale :

```bash theme={null}
mint update
```

Si la commande `mint update` n’est pas disponible dans votre environnement local, réinstallez l’interface en ligne de commande (CLI) avec la dernière version :

<CodeGroup>
  ```bash npm theme={null}
  npm i -g mint@latest
  ```

  ```bash pnpm theme={null}
  pnpm add -g mint@latest
  ```
</CodeGroup>

<div id="custom-ports">
  ## Ports personnalisés
</div>

Par défaut, l’interface en ligne de commande (CLI) utilise le port 3000. Vous pouvez définir un port personnalisé à l’aide de l’option `--port`. Pour exécuter la CLI sur le port 3333, par exemple, utilisez cette commande :

```bash theme={null}
mint dev --port 3333
```

Si vous essayez d’exécuter sur un port déjà utilisé, le prochain port disponible sera automatiquement choisi :

```mdx theme={null}
Le port 3000 est déjà utilisé. Tentative sur le port 3001 à la place.
```

<div id="previewing-as-a-specific-group">
  ## Prévisualiser en tant que groupe spécifique
</div>

Si vous utilisez une authentification partielle pour restreindre l’accès à votre documentation, vous pouvez prévisualiser en tant que groupe d’authentification spécifique en utilisant l’option `--group [groupname]`.

Par exemple, si vous avez un groupe nommé `admin`, vous pouvez prévisualiser en tant que membre de ce groupe avec la commande :

```bash theme={null}
mint dev --group admin
```

<div id="additional-commands">
  ## Commandes supplémentaires
</div>

Bien que `mint dev` soit la commande la plus utilisée, d’autres commandes vous permettent également de gérer votre documentation.

<div id="finding-broken-links">
  ### Recherche de liens brisés
</div>

L’interface en ligne de commande (CLI) peut vous aider à valider les liens de référence présents dans votre documentation. Pour identifier les liens brisés, utilisez la commande suivante :

```bash theme={null}
mint broken-links
```

<div id="checking-openapi-spec">
  ### Vérification de la spécification OpenAPI
</div>

Vous pouvez utiliser l’interface en ligne de commande (CLI) pour vérifier votre fichier OpenAPI à la recherche d’erreurs avec la commande suivante :

```bash theme={null}
mint openapi-check <nomFichierOuUrlOpenapi>
```

Vous pouvez fournir un nom de fichier (par exemple « ./openapi.yaml ») ou une URL (par exemple « [https://petstore3.swagger.io/api/v3/openapi.json](https://petstore3.swagger.io/api/v3/openapi.json) »).

<div id="renaming-files">
  ### Renommer des fichiers
</div>

Vous pouvez renommer des fichiers et mettre à jour toutes les références vers ceux-ci avec la commande suivante :

```bash theme={null}
mint rename <ancienNomDeFichier> <nouveauNomDeFichier>
```

<div id="migrating-mdx-endpoint-pages">
  ### Migration des pages d’endpoint MDX
</div>

Vous pouvez migrer des pages d’endpoint MDX vers des pages générées automatiquement à partir de votre spécification OpenAPI à l’aide de la commande suivante :

```bash theme={null}
mint migrate-mdx
```

Cette commande convertit les pages MDX d’endpoint individuelles en pages générées automatiquement définies dans votre `docs.json`, déplace le contenu MDX vers l’extension `x-mint` dans votre spécification OpenAPI et met à jour votre navigation. Consultez [Migrer depuis MDX](/fr/api-playground/migrating-from-mdx) pour en savoir plus.

<div id="formatting">
  ## Mise en forme
</div>

Lors du développement en local, nous recommandons d’utiliser des extensions dans votre IDE pour reconnaître et formater les fichiers `MDX`.

Si vous utilisez Cursor, Windsurf ou VS Code, nous recommandons l’[extension MDX pour VS Code](https://marketplace.visualstudio.com/items?itemName=unifiedjs.vscode-mdx) pour la coloration syntaxique, ainsi que [Prettier](https://marketplace.visualstudio.com/items?itemName=esbenp.prettier-vscode) pour le formatage du code.

Si vous utilisez JetBrains, nous recommandons le [plug-in MDX pour IntelliJ IDEA](https://plugins.jetbrains.com/plugin/14944-mdx) pour la coloration syntaxique, ainsi que la configuration de [Prettier](https://prettier.io/docs/webstorm) pour le formatage du code.

<div id="troubleshooting">
  ## Dépannage
</div>

<AccordionGroup>
  <Accordion title="Erreur : impossible de charger le module &#x22;sharp&#x22; avec l’environnement d’exécution darwin-arm64">
    Cela peut être dû à une version obsolète de Node. Essayez ce qui suit :

    1. Désinstallez la version actuellement installée de l’interface en ligne de commande (CLI) Mint : `npm uninstall -g mint`
    2. Mettez à jour vers Node.js.
    3. Réinstallez la CLI Mint : `npm install -g mint`
  </Accordion>

  <Accordion title="Problème : erreur inconnue">
    **Solution** : Accédez à la racine de votre appareil et supprimez le dossier `~/.mintlify`. Ensuite, exécutez de nouveau `mint dev`.
  </Accordion>

  <Accordion title="Erreur : permission refusée">
    Cela est dû au fait que vous n’avez pas les autorisations nécessaires pour installer globalement des paquets Node.

    **Solution** : Essayez d’exécuter `sudo npm i -g mint`. Votre mot de passe vous sera demandé ; il s’agit de celui que vous utilisez pour déverrouiller votre ordinateur.
  </Accordion>

  <Accordion title="L’aperçu local n’a pas le même rendu que ma documentation en ligne">
    Cela est probablement dû à une version obsolète de la CLI.

    **Solution :** Exécutez `mint update` pour récupérer les dernières modifications.
  </Accordion>

  <Accordion title="mintlify vs. paquet mint">
    Si vous rencontrez des problèmes avec le paquet CLI, commencez par exécuter `npm ls -g`. Cette commande affiche les paquets installés globalement sur votre machine.

    Si vous n’utilisez pas npm ou ne le voyez pas dans la liste -g, essayez `which mint` pour localiser l’installation.

    Si vous avez un paquet nommé `mint` et un paquet nommé `mintlify` installés, vous devez désinstaller `mintlify`.

    1. Désinstallez l’ancien paquet :

    ```bash theme={null}
      npm uninstall -g mintlify
    ```

    2. Videz le cache npm :

    ```bash theme={null}
      npm cache clean --force
    ```

    3. Réinstallez le nouveau paquet :

    ```bash theme={null}
    npm i -g mint
    ```
  </Accordion>
</AccordionGroup>