# Publier des modifications (/fr/editor/publish)

<!-- agent-signals: reading_time_min: 7 · est_tokens: 2851 · updated: 2026-09-23 -->
Related: [Comment utiliser l'éditeur](/fr/editor/tutorial.md), [Créer et modifier des pages](/fr/editor/pages.md), [Réviser les modifications](/fr/editor/review.md), [Collaborer dans l'éditeur](/fr/editor/collaborate.md), [Interroger l'agent](/fr/editor/agent.md), [Paramètres de l'éditeur pour l'IA et la publication](/fr/editor/settings.md)

Vos modifications sont enregistrées automatiquement pendant que vous travaillez, mais elles n'atteignent votre site publié que lorsque vous les publiez. Ce qui se passe lorsque vous publiez dépend de la branch sur laquelle vous travaillez et du fait que cette branch soit protégée ou non.

<Note>
  S'il n'y a pas de bouton **Publish** dans la barre d'outils de votre éditeur, la [publication automatique](#auto-publish) est activée sur votre deployment et vos modifications sont mises en ligne automatiquement.

  S'il n'y a pas de sélecteur de branch, [affichez le sélecteur de branch](#show-the-branch-selector).

  Si vous ne voyez que vos propres modifications dans le menu **Publish**, activez la [publication granulaire](#publish-specific-changes) pour voir les modifications de tout le monde.
</Note>

<div id="pending-changes">
  ## Modifications en attente [#modifications-en-attente]
</div>

Sur votre deployment branch, l'éditeur considère les éléments suivants comme des modifications en attente jusqu'à ce que vous les publiiez :

* 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

Cliquez sur **Publish** dans la barre d'outils pour voir vos modifications en attente. Cliquez sur n'importe quel fichier modifié pour le comparer à la version publiée.

<div id="what-happens-when-you-publish">
  ## Ce qui se passe lorsque vous publiez [#ce-qui-se-passe-lorsque-vous-publiez]
</div>

| Type de branch                                                                                                                                                    | Protection de branch   | Actions disponibles                                                    |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------- | ---------------------------------------------------------------------- |
| <Tooltip tip="La branch qui publie vers votre site publié, généralement 'main'." headline="Deployment branch">Deployment branch</Tooltip>                         | Aucune                 | **Publish** directement vers votre site publié                         |
| Deployment branch                                                                                                                                                 | Pull requests requises | **Create branch** pour déplacer votre travail vers une nouvelle branch |
| <Tooltip tip="Une branch isolée sur laquelle vous travaillez avant de fusionner dans votre deployment branch." headline="Feature branch">Feature branch</Tooltip> | Aucune                 | **Request review**, puis **Merge and publish**                         |
| Feature branch                                                                                                                                                    | Protégée               | **Create branch** pour continuer à modifier sur une nouvelle branch    |

* **Publish** : Commit vos modifications en attente sur votre deployment branch et les déploie sur votre site publié.
* **Request review** : Marque la pull request de la branch comme prête à être relue.
* **Merge and publish** : Fusionne la pull request dans votre deployment branch et la déploie. Disponible dès que la pull request est prête ou approuvée, selon les exigences de relecture de votre dépôt.
* **Create branch** : Crée une nouvelle feature branch lorsque vous ne pouvez pas publier sur la branch actuelle.

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.

<Note>
  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](https://app.mintlify.com).
</Note>

<div id="invalid-mdx-blocks-publishing">
  ### Un MDX non valide bloque la publication [#un-mdx-non-valide-bloque-la-publication]
</div>

Si une page de votre branch comporte un MDX non valide, l'éditeur désactive les boutons **Publish** et **Request review** jusqu'à ce que vous le corrigiez. Survolez **Publish** pour voir combien de pages ont des erreurs, puis ouvrez chaque page en mode source pour repérer et corriger l'erreur. Consultez [Bouton Publish désactivé à cause d'un MDX non valide](/fr/help-center/publish-button-disabled-invalid-mdx) pour plus de détails.

<div id="publish-specific-changes">
  ## Publier des modifications spécifiques [#publier-des-modifications-spécifiques]
</div>

Lorsque plusieurs personnes ont des modifications en attente sur votre deployment branch, le paramètre [**Granular publishing**](/fr/editor/settings#granular-publishing) contrôle quelles modifications le menu **Publish** affiche.

**Publication granulaire désactivée (par défaut)** : Le menu **Publish** n'affiche que vos modifications. Cela comprend les fichiers que vous avez modifiés, les fichiers modifiés à la fois par vous et vos collègues, ainsi que les fichiers sans auteur enregistré. **Publish** et **Discard all** ne s'appliquent qu'à ces modifications. Si vos collègues ont d'autres modifications en attente, un avis indique que leurs modifications sont masquées.

**Publication granulaire activée** : Le menu **Publish** répartit les modifications en attente entre **Your changes** et **Modified by others**. Vos modifications sont sélectionnées par défaut, tandis que celles des autres ne le sont pas. Utilisez les cases à cocher pour choisir les modifications à publier. Chaque section dispose de son propre bouton **Discard**.

Une icône de contributeurs marque les fichiers modifiés par une autre personne que vous. Survolez-la pour voir qui a modifié le fichier.

* La publication granulaire ne s'applique que sur une deployment branch sans protections de branch. Sur les feature branches, la publication inclut toutes les modifications en attente.
* Supprimer un dossier supprime toutes les pages qu'il contient. Ces suppressions sont publiées ensemble. Vous ne pouvez pas supprimer partiellement un dossier.
* Certaines modifications dépendent les unes des autres, comme une page et son entrée de navigation. Si votre sélection omet une modification dont dépend une modification sélectionnée, la publication échoue avec une erreur. Ajustez votre sélection pour inclure la dépendance, puis publiez à nouveau.

<div id="work-on-a-branch">
  ## Travailler sur une branch [#travailler-sur-une-branch]
</div>

Modifiez directement sur votre deployment branch si vous n'utilisez pas de workflow de révision. Créez une branch si chaque modification passe par une révision avant d'atteindre votre site publié.

Pour créer une branch :

1. Cliquez sur le nom de la branch dans la barre d'outils de l'éditeur. Sur votre deployment branch, le nom comporte un badge **Live**.
2. Vous pouvez saisir un titre pour votre branch dans **Find a branch**.
3. Cliquez sur **New branch**.

Si vous ne saisissez pas de titre, l'éditeur nomme la branch d'après la date actuelle. Si vous avez des modifications en attente au moment où vous créez une branch, l'éditeur vous demande si vous voulez **Bring them to this branch** ou **Leave them behind**. Votre branch d'origine conserve ses modifications en attente dans les deux cas.

Les modifications effectuées sur une branch que vous avez créée dans l'éditeur sont commitées automatiquement sur la branch, environ 15 secondes après que vous arrêtez d'écrire. Le premier commit ouvre une pull request vers votre deployment branch. La pull request s'ouvre en brouillon si [Create draft pull requests by default](/fr/editor/settings#create-draft-pull-requests-by-default) est activé.

Lorsque vos modifications sont prêtes, cliquez sur **Publish**, puis sur **Request review**. Une fois que votre pull request répond aux exigences de relecture de votre dépôt, cliquez sur **Merge and publish**. L'éditeur fusionne la pull request et vous ramène sur votre deployment branch.

<div id="manage-branches">
  ### Gérer les branches [#gérer-les-branches]
</div>

Le menu des branches liste votre deployment branch et les branches ayant une pull request ouverte, y compris les pull requests ouvertes en dehors de l'éditeur. Chaque branch affiche l'état de sa pull request. Pour trouver une branch fusionnée ou fermée, recherchez-la par son nom.

Pour renommer ou supprimer une branch, survolez-la dans le menu des branches et cliquez sur **Rename branch** ou **Delete branch**. Supprimer une branch la retire définitivement de votre dépôt, ainsi que toutes les modifications non publiées qu'elle contient.

<div id="show-the-branch-selector">
  ### Afficher le sélecteur de branch [#afficher-le-sélecteur-de-branch]
</div>

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 <Icon icon="<svg xmlns=&#x22;http://www.w3.org/2000/svg&#x22; viewBox=&#x22;0 0 24 24&#x22; fill=&#x22;none&#x22;><path d=&#x22;M12 12.002H12.5M19 12.002H19.5M5 12.002H5.5M12 13.002C12.5523 13.002 13 12.5542 13 12.002C13 11.4497 12.5523 11.002 12 11.002C11.4477 11.002 11 11.4497 11 12.002C11 12.5542 11.4477 13.002 12 13.002ZM19 13.002C19.5523 13.002 20 12.5542 20 12.002C20 11.4497 19.5523 11.002 19 11.002C18.4477 11.002 18 11.4497 18 12.002C18 12.5542 18.4477 13.002 19 13.002ZM5 13.002C5.55228 13.002 6 12.5542 6 12.002C6 11.4497 5.55228 11.002 5 11.002C4.44772 11.002 4 11.4497 4 12.002C4 12.5542 4.44772 13.002 5 13.002Z&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/></svg>" /> **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 deployment branch a des protections de branch ou lorsque vous travaillez sur une feature branch.

<div id="resolve-conflicts">
  ## Résoudre les conflits [#résoudre-les-conflits]
</div>

Lorsque quelqu'un pousse des modifications vers votre dépôt en dehors de l'éditeur, l'éditeur fusionne ses modifications dans les pages que vous avez ouvertes. Une notification vous indique combien de mises à jour ont été appliquées.

Si une modification distante et la vôtre portent sur la même partie d'une page, l'éditeur conserve les deux versions et les met en évidence. Passez en revue le contenu mis en évidence, conservez la version que vous souhaitez et supprimez l'autre.

<div id="commit-signing">
  ## Signature des commits [#signature-des-commits]
</div>

Signez vos commits avec votre compte GitHub en l'autorisant dans les [paramètres de votre compte](https://app.mintlify.com/settings/account). Sans cette autorisation, la GitHub App de Mintlify signe les commits effectués dans l'éditeur.

<div id="auto-publish">
  ## Publication automatique [#publication-automatique]
</div>

Si la [publication automatique](/fr/editor/settings#auto-publish) 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.