> ## 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.

# Aperçus de déploiement

> Obtenez des URL d’aperçu uniques pour chaque pull request afin que les réviseurs voient les modifications de documentation en direct avant la fusion.

Les aperçus de déploiement vous permettent de voir à quoi ressemblent les modifications de votre documentation avant la fusion en production. Chaque aperçu crée une URL partageable qui se met automatiquement à jour lorsque vous poussez de nouvelles modifications.

Par défaut, les URL d’aperçu sont publiques. Partagez un lien d’aperçu avec toute personne qui doit examiner vos modifications.

<div id="create-preview-deployments">
  ## Créer des déploiements de prévisualisation
</div>

Les déploiements de prévisualisation sont créés automatiquement via des pull requests (demandes de fusion) ou manuellement depuis votre Dashboard.

<div id="automatic-previews">
  ### Aperçus automatiques
</div>

<Note>
  Les aperçus automatiques ne sont créés que pour les pull requests (demandes de fusion) qui ciblent votre [branche de déploiement](/fr/guides/git-concepts#deployment-branch).
</Note>

Lorsque vous créez une pull request (demande de fusion), le bot Mintlify ajoute automatiquement un lien pour afficher le déploiement de prévisualisation dans votre pull request. L’aperçu est mis à jour chaque fois que vous poussez de nouveaux commits sur la branche.

<Frame>
  <img src="https://mintcdn.com/mintlify-docs-automation-github-pr-review/QBTK2PGeDDpdhDBw/images/previews/preview-deployment-light.png?fit=max&auto=format&n=QBTK2PGeDDpdhDBw&q=85&s=79f5f4f0da1814e9c51490799bec3114" alt="Lien pour afficher le déploiement dans la chronologie de la pull request" className="block dark:hidden" width="1704" height="142" data-path="images/previews/preview-deployment-light.png" />

  <img src="https://mintcdn.com/mintlify-docs-automation-github-pr-review/QBTK2PGeDDpdhDBw/images/previews/preview-deployment-dark.png?fit=max&auto=format&n=QBTK2PGeDDpdhDBw&q=85&s=4639f11883aa7edd23735abc748898b5" alt="Lien pour afficher le déploiement dans la chronologie de la pull request" className="hidden dark:block" width="1704" height="142" data-path="images/previews/preview-deployment-dark.png" />
</Frame>

<div id="manual-previews">
  ### Aperçus manuels
</div>

Vous pouvez créer manuellement un aperçu pour n’importe quelle branche.

1. Accédez à votre [Dashboard](https://dashboard.mintlify.com/).
2. Sélectionnez **Previews**.
3. Sélectionnez **Create custom preview**.
4. Entrez le nom de la branche à prévisualiser.
5. Sélectionnez **Create preview**.

<div id="api">
  ### API
</div>

Vous pouvez également créer des déploiements de prévisualisation de manière programmatique en utilisant l'endpoint de l'API [Trigger preview deployment](/fr/api/preview/trigger). Cela est utile pour intégrer la création de prévisualisations dans des pipelines CI/CD ou des outils personnalisés.

<div id="redeploy-a-preview">
  ## Redéployer un aperçu
</div>

Redéployez un aperçu pour actualiser le contenu ou réessayer après un déploiement ayant échoué.

1. Sélectionnez l’aperçu dans votre [Dashboard](https://dashboard.mintlify.com/).
2. Sélectionnez **Redéployer**.

<Frame>
  <img src="https://mintcdn.com/mintlify-docs-automation-github-pr-review/QBTK2PGeDDpdhDBw/images/previews/redeploy-preview-light.png?fit=max&auto=format&n=QBTK2PGeDDpdhDBw&q=85&s=c88118a75c184863d196d42632c64212" alt="Le menu Previews avec le bouton de déploiement mis en évidence par un rectangle orange." className="block dark:hidden" width="2104" height="634" data-path="images/previews/redeploy-preview-light.png" />

  <img src="https://mintcdn.com/mintlify-docs-automation-github-pr-review/QBTK2PGeDDpdhDBw/images/previews/redeploy-preview-dark.png?fit=max&auto=format&n=QBTK2PGeDDpdhDBw&q=85&s=c77c6bb0bfc8e29fe0d63ba641679c31" alt="Le menu Previews avec le bouton de déploiement mis en évidence par un rectangle orange." className="hidden dark:block" width="2104" height="634" data-path="images/previews/redeploy-preview-dark.png" />
</Frame>

<div id="preview-widget">
  ## Widget d’aperçu
</div>

Le widget d’aperçu apparaît sur les déploiements de prévisualisation pour vous aider à naviguer et à consulter les pages mises à jour. Le widget se présente sous la forme d’un bouton flottant dans le coin inférieur droit de votre déploiement de prévisualisation.

<Frame>
  <img src="https://mintcdn.com/mintlify-docs-automation-github-pr-review/QBTK2PGeDDpdhDBw/images/previews/widget-light.png?fit=max&auto=format&n=QBTK2PGeDDpdhDBw&q=85&s=f3619196efa05df60ee5c277e84807cb" alt="Widget d’aperçu agrandi affichant la liste des fichiers modifiés." className="block dark:hidden" width="820" height="314" data-path="images/previews/widget-light.png" />

  <img src="https://mintcdn.com/mintlify-docs-automation-github-pr-review/QBTK2PGeDDpdhDBw/images/previews/widget-dark.png?fit=max&auto=format&n=QBTK2PGeDDpdhDBw&q=85&s=6710faa5806f010b21f06d52a05866d3" alt="Widget d’aperçu agrandi affichant la liste des fichiers modifiés." className="hidden dark:block" width="820" height="314" data-path="images/previews/widget-dark.png" />
</Frame>

1. Cliquez sur le widget pour afficher tous les fichiers ajoutés, modifiés ou supprimés dans l’aperçu.
2. Cliquez sur un fichier pour voir les modifications sur la page correspondante.
3. Utilisez la barre de recherche pour filtrer la liste des fichiers modifiés.
4. Survolez un fichier et cliquez sur l'icône **Ouvrir dans l'éditeur** pour modifier le fichier directement dans l'éditeur web.

Le widget apparaît uniquement sur les déploiements de prévisualisation, et non sur votre site en production ni dans vos aperçus locaux.

<div id="restrict-access-to-preview-deployments">
  ## Restreindre l'accès aux déploiements de prévisualisation
</div>

Par défaut, les déploiements de prévisualisation sont accessibles publiquement à toute personne disposant de l'URL. Vous pouvez restreindre l'accès en exigeant l'authentification de l'organisation pour tous les aperçus ou en protégeant par mot de passe des aperçus individuels.

<div id="require-organization-authentication">
  ### Exiger l'authentification de l'organisation
</div>

Restreignez l'accès aux aperçus aux membres authentifiés de votre organisation Mintlify.

1. Accédez à la section **Previews** sur la page [Modules complémentaires](https://dashboard.mintlify.com/products/addons) de votre Dashboard.
2. Activez ou désactivez l'interrupteur **Preview authentication** pour gérer l'authentification des prévisualisations.

<Frame>
  <img src="https://mintcdn.com/mintlify-docs-automation-github-pr-review/QBTK2PGeDDpdhDBw/images/previews/preview-auth-light.png?fit=max&auto=format&n=QBTK2PGeDDpdhDBw&q=85&s=88ea15092ae64e7d8fa57c0deb2a2af1" alt="L'interrupteur d'authentification des prévisualisations sur la page Modules complémentaires" className="block dark:hidden" width="1460" height="434" data-path="images/previews/preview-auth-light.png" />

  <img src="https://mintcdn.com/mintlify-docs-automation-github-pr-review/QBTK2PGeDDpdhDBw/images/previews/preview-auth-dark.png?fit=max&auto=format&n=QBTK2PGeDDpdhDBw&q=85&s=eab0092b5a08628864ff6abe337d0131" alt="L'interrupteur d'authentification des prévisualisations sur la page Modules complémentaires" className="hidden dark:block" width="1460" height="434" data-path="images/previews/preview-auth-dark.png" />
</Frame>

<div id="password-protect-an-individual-preview">
  ### Protéger un aperçu individuel par mot de passe
</div>

<Info>
  Les aperçus protégés par mot de passe sont disponibles avec les [offres Enterprise](https://mintlify.com/pricing?ref=preview-deployments).
</Info>

Protégez par mot de passe un aperçu spécifique pour le partager avec des réviseurs externes sans les ajouter à votre organisation Mintlify. Cette option est disponible lors de la création d'un aperçu manuel et n'apparaît pas lorsque l'authentification de l'organisation est déjà activée pour votre déploiement.

1. Accédez à votre [Dashboard](https://dashboard.mintlify.com/).
2. Sélectionnez **Previews**.
3. Sélectionnez **Create custom preview**.
4. Entrez le nom de la branche à prévisualiser.
5. Activez **Make private** et saisissez un mot de passe. Les mots de passe doivent contenir au moins 8 caractères.

<Frame>
  <img src="https://mintcdn.com/mintlify-docs-automation-github-pr-review/QBTK2PGeDDpdhDBw/images/previews/private-preview-light.png?fit=max&auto=format&n=QBTK2PGeDDpdhDBw&q=85&s=1ce1fcf395e53e48d878fd9c0465b5e2" alt="La fenêtre Créer un aperçu personnalisé avec l'interrupteur Make private activé et un champ de mot de passe." className="block dark:hidden" width="820" height="764" data-path="images/previews/private-preview-light.png" />

  <img src="https://mintcdn.com/mintlify-docs-automation-github-pr-review/QBTK2PGeDDpdhDBw/images/previews/private-preview-dark.png?fit=max&auto=format&n=QBTK2PGeDDpdhDBw&q=85&s=34a0a6fe338673009d2c35e258c5a062" alt="La fenêtre Créer un aperçu personnalisé avec l'interrupteur Make private activé et un champ de mot de passe." className="hidden dark:block" width="814" height="750" data-path="images/previews/private-preview-dark.png" />
</Frame>

6. Sélectionnez **Create preview**.

<div id="troubleshooting-preview-deployments">
  ## Dépannage des déploiements de prévisualisation
</div>

Si votre déploiement de prévisualisation échoue, essayez les étapes de dépannage suivantes.

* **Consulter les journaux de build** : Dans votre [Dashboard](https://dashboard.mintlify.com/), allez dans **Previews** et cliquez sur la prévisualisation en échec. Les journaux de déploiement affichent les erreurs qui ont provoqué l’échec.
* **Vérifier votre configuration** :
  * Syntaxe `docs.json` non valide
  * Chemins de fichiers manquants ou incorrects référencés dans votre navigation
  * Frontmatter non valide dans les fichiers MDX
  * Liens d’images cassés ou fichiers d’images manquants
* **Valider en local** : Exécutez `mint dev` en local pour détecter les erreurs de build avant de pousser vers le référentiel.
* **Vérifier les changements récents** : Passez en revue les commits les plus récents dans votre branche pour identifier les modifications qui ont entraîné l’échec du build.
