Skip to main content
Vos modifications sont enregistrées automatiquement pendant que vous travaillez, mais elles n’atteignent votre site publié que lorsque vous les publiez. L’enregistrement automatique conserve vos modifications comme des modifications en attente dans l’éditeur. Publier ou enregistrer dans une branch les commit dans votre dépôt Git. Ce qui se passe alors dépend de la branch sur laquelle vous travaillez et du fait que cette branch exige ou non des pull requests.
Si vous ne voyez pas de bouton Publish, la publication automatique est activée sur votre deployment et vos modifications sont mises en ligne automatiquement. Si vous ne voyez pas de sélecteur de branch, affichez le sélecteur de branch.

​
Modifications en attente

L’éditeur considère les éléments suivants comme des modifications en attente :
  • Les modifications de contenu dans les pages
  • Les pages ajoutées ou supprimées
  • Les changements de structure de navigation
  • Les médias téléversés
  • Les mises à jour de configuration
S’il n’y a aucune modification en attente, l’éditeur désactive les actions de publication et d’enregistrement.

​
Ce qui se passe lorsque vous publiez

  • Publish : Commit et déploie vos modifications vers votre site publié immédiatement.
  • Save in branch : Commit vos modifications sur la feature branch sans fusionner dans votre deployment branch.
  • Create branch : Déplace vos modifications en attente vers une nouvelle feature branch lorsque vous êtes sur une deployment branch protégée.
  • Create pull request : Ouvre une pull request vers votre deployment branch.
Une seule publication peut avoir lieu à la fois par branch. Si un collègue publie sur la même branch, attendez la fin de sa publication avant de réessayer.
Votre site est mis à jour une fois que Mintlify a compilé et déployé vos modifications. Cela prend généralement de 30 secondes à quelques minutes. Consultez l’état du déploiement sur votre dashboard.

​
Quand utiliser une branch

Travaillez directement sur votre deployment branch si vous n’utilisez pas de workflow basé sur Git. Créez une branch si chaque modification passe par une révision avant d’atteindre votre site publié. Pour créer une branch, cliquez sur le nom de la branch dans la barre d’outils de l’éditeur, sélectionnez Create new branch, saisissez un nom, puis cliquez sur Create branch.
Créer une branch alors que vous avez des modifications non publiées vous invite à les emporter avec vous ou à les laisser. Les modifications que vous laissez restent sur la branch d’origine. Passer à une branch existante n’affiche aucune invite et les modifications non enregistrées sont perdues. Enregistrez votre travail avant de changer de branch. Consultez Travailler avec des branches.

​
Afficher le sélecteur de branch

Si votre deployment branch n’a pas de protections de branch, l’éditeur masque le sélecteur de branch lorsque vous travaillez sur la deployment branch. Pour l’afficher, cliquez sur More options dans la barre supérieure, puis activez Branches. Cette préférence ne s’applique qu’à vous. Le sélecteur de branch apparaît toujours lorsque votre dépôt exige des pull requests ou lorsque vous travaillez sur une feature branch.

​
Résoudre les conflits

Les conflits surviennent lorsque votre branch et la deployment branch comportent des modifications incompatibles sur les mêmes fichiers. Par exemple, lorsque vous et un collègue modifiez les mêmes lignes ou déplacez un fichier vers des emplacements différents. Lorsque quelqu’un pousse des modifications vers votre dépôt en dehors de l’éditeur, l’éditeur applique automatiquement celles qui ne se chevauchent pas. Si une modification distante et la vôtre portent sur la même partie d’une page, l’éditeur met le conflit en évidence. L’éditeur affiche un avertissement lorsque des conflits empêchent la publication. Suivez les instructions pour choisir la version à conserver pour chaque section en conflit.

​
Signature des commits

Signez vos commits avec votre compte GitHub en l’autorisant dans les paramètres de votre compte. Sans cette autorisation, la GitHub App de Mintlify signe les commits effectués dans l’éditeur.

​
Publication automatique

Si la publication automatique (appelée Autocommits sur la branch main dans les paramètres de l’éditeur) est activée sur votre deployment, l’éditeur commit sur votre deployment branch peu après que vous arrêtez d’écrire. Le sélecteur de branch et le bouton Publish sont masqués. Il n’y a ni état en attente ni étape de révision. Les modifications sur les feature branches créées depuis l’éditeur sont commitées automatiquement dans les deux cas, mais elles ne sont jamais publiées tant que vous ne les fusionnez pas dans votre deployment branch.