Passer au contenu principal
Prévisualisez vos modifications avant qu’elles n’atteignent votre site publié, demandez une révision sur votre pull request et fusionnez-la depuis l’éditeur.

​
Aperçu en direct

L’aperçu en direct affiche votre site pendant que vous le modifiez, sans étape de compilation. Sur l’onglet Site, cliquez sur Preview dans la barre supérieure. L’aperçu s’ouvre en plein écran. Cliquez sur Refresh preview pour le recharger, ou sur Close preview pour revenir à l’éditeur. Pour ouvrir l’aperçu dans un nouvel onglet du navigateur à la place, activez Open live preview in new tab. Pour modifier les paramètres du site et voir leur effet sur votre contenu, cliquez sur Site settings dans la barre d’outils de l’aperçu, puis sélectionnez une section de configuration. Pour ouvrir l’agent à côté de l’aperçu, cliquez sur Ask agent dans la barre d’outils de l’aperçu. Seuls les editors et les admins peuvent utiliser l’agent dans les aperçus en direct.
L’aperçu en direct n’est disponible que pour les sites publics et les sites protégés par l’authentification Mintlify.

​
Déploiements de prévisualisation

Lorsque votre feature branch comporte une pull request, Mintlify compile un déploiement de prévisualisation : une URL temporaire où vos modifications s’affichent exactement comme elles le seront une fois publiées. L’aperçu est recompilé chaque fois que l’éditeur commit de nouvelles modifications sur la branch. L’URL combine le sous-domaine de votre projet et le nom de la branch : <subdomain>-<branch-name>.mintlify.site. Retrouvez l’URL exacte dans le commentaire de pull request du bot Mintlify. Les URLs de prévisualisation sont accessibles publiquement par défaut. Pour en restreindre l’accès aux membres de votre organisation Mintlify, activez l’authentification des aperçus dans la section Previews de la page Général de votre dashboard. Consultez Restreindre l’accès aux déploiements de prévisualisation pour plus d’informations.

​
Quel aperçu utiliser

Pour diriger un collègue vers une page précise d’une branch, cliquez sur More options en haut à droite de la page, puis sur Copy link. Toute personne ayant accès à votre organisation Mintlify peut ouvrir le lien dans sa propre session de l’éditeur.

​
Réviser et fusionner les pull requests

Lorsque votre branch comporte une pull request, le menu de publication affiche ses fichiers modifiés et son état de révision, comme Draft in progress, Review required, Changes requested ou Approved. Cliquez sur View request pour ouvrir la pull request chez votre fournisseur Git.
Si la branch comporte encore des fils de commentaires non résolus, le menu de publication affiche un avertissement indiquant le nombre de commentaires ouverts à la place de Ready to publish ou Approved. Vous pouvez toujours fusionner et publier. L’avertissement vous rappelle de traiter les retours au préalable.
  1. Cliquez sur Publish dans la barre supérieure, puis sur Request review. Cela marque la pull request comme prête à être relue.
  2. Les relecteurs approuvent la pull request chez votre fournisseur Git.
  3. Cliquez sur Publish, puis sur Merge and publish. L’éditeur fusionne la pull request, déploie vos modifications et vous ramène sur votre deployment branch.
Si Mintlify héberge votre dépôt et qu’aucune approbation n’est requise, le menu de publication affiche Publish à la place, qui fusionne et déploie en une seule étape.
Configurez des règles de protection de branch chez votre fournisseur Git pour exiger des pull requests. Consultez About protected branches dans l’aide GitHub ou Protected branches dans l’aide GitLab.

​
Comparer les modifications avant de fusionner

Cliquez sur n’importe quel fichier modifié dans le menu de publication pour l’ouvrir en vue diff face à la version publiée. Pour quitter la vue diff, cliquez sur Viewing changes dans la barre supérieure. Le mode visuel affiche un diff visuel et le mode source affiche un diff textuel. Les fichiers qui ne peuvent pas afficher de diff, comme les images ou les fichiers supprimés, figurent dans la liste mais ne sont pas cliquables. Vous pouvez ouvrir depuis le menu de publication les pages masquées qui apparaissent dans le diff de la branch, même si elles ne figurent pas dans la navigation de votre site.

​
Titres et descriptions des pull requests

Le titre de la pull request reprend le titre de votre branch. Si votre branch comporte des fils de commentaires ouverts, Mintlify ajoute leur résumé à la description de la pull request. Consultez Collaborer.

​
Réviser une exécution d’automatisation

Lorsqu’une automatisation ouvre une pull request, cliquez sur View changes dans la notification Slack ou l’e-mail de notification pour ouvrir l’éditeur sur la branch de l’automatisation. L’éditeur s’ouvre en vue diff, et l’agent s’ouvre à côté avec le contexte de ce qu’a fait l’automatisation. Pour ouvrir plutôt le déploiement de prévisualisation de l’automatisation, cliquez sur Preview sur l’exécution dans l’onglet Runs de la page Automations de votre dashboard.

Sujets connexes

Qu'est-ce que l'agent ?Gérer les automatisationsProxy inverse