Passer au contenu principal
Les aperçus de déploiement sont disponibles avec les offres Pro et Custom.
Les aperçus de déploiement vous permettent de voir à quoi ressembleront 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.

​
Créer des déploiements de prévisualisation

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

​
Aperçus automatiques

Les aperçus automatiques ne sont créés que pour les pull requests (demandes de fusion) qui ciblent votre branche de déploiement.
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.
Lien pour afficher le déploiement dans la chronologie de la pull request

​
Aperçus manuels

Vous pouvez créer manuellement un aperçu pour n’importe quelle branche.
  1. Accédez à votre Dashboard.
  2. Sélectionnez Previews.
  3. Sélectionnez Create custom preview.
  4. Entrez le nom de la branche à prévisualiser.
  5. Sélectionnez Create deployment.

​
Redéployer un aperçu

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 depuis votre Dashboard.
  2. Sélectionnez Redéployer.
Le menu Previews avec le bouton de déploiement mis en évidence par un rectangle orange.

​
Restreindre l’accès aux déploiements de prévisualisation

Par défaut, les déploiements de prévisualisation sont accessibles publiquement à toute personne disposant de l’URL. Vous pouvez en restreindre l’accès aux membres authentifiés de votre organisation Mintlify.
  1. Accédez à la section Previews sur la page Modules complémentaires de votre Dashboard.
  2. Activez ou désactivez l’interrupteur Preview authentication pour gérer l’authentification des prévisualisations.
L’interrupteur d’authentification des prévisualisations sur la page Modules complémentaires

​
Dépannage des déploiements de prévisualisation

Si votre déploiement de prévisualisation échoue, essayez les étapes de dépannage suivantes.
  • Consultez les journaux de build : Dans votre dashboard, allez dans Previews et cliquez sur la prévisualisation ayant échoué. Les journaux de déploiement affichent les erreurs qui ont provoqué l’échec du déploiement.
  • Vérifiez votre configuration :
    • Syntaxe docs.json invalide
    • Chemins de fichiers manquants ou incorrects référencés dans votre navigation
    • Frontmatter invalide dans les fichiers MDX
    • Liens d’images cassés ou fichiers d’images manquants
  • Validez en local : Exécutez mint dev en local pour détecter les erreurs de build avant de pousser sur le dépôt.
  • Vérifiez les modifications récentes : Passez en revue les derniers commits dans votre branche pour identifier les modifications qui ont provoqué l’échec du build.