---
title: Éditeur web
description: "Modifiez vos docs Jamdesk dans le navigateur : parcourez le dépôt, éditez le MDX en preview et commitez sur GitHub pour lancer un build automatique."
---

> **For AI agents:** the complete documentation index is at [llms.txt](/docs/llms.txt). Append `.md` to any page URL for its markdown version.

L'éditeur web vous permet de modifier votre documentation directement dans le dashboard Jamdesk — pas d'installation locale, pas de terminal, pas de commandes Git. Ouvrez une page, modifiez son MDX avec un preview en direct à côté de vous, puis commitez vos changements sur votre branche GitHub. Chaque commit déclenche automatiquement un build, si bien que vos changements sont mis en ligne de la même façon qu'un `git push` le ferait.

C'est l'équivalent dans le navigateur du [preview local](/fr/development/local-preview) et de l'[extension VS Code](/fr/development/vscode-extension) — utilisez-le pour faire une modification rapide depuis n'importe où, ou quand vous préférez ne pas cloner le dépôt du tout.

## Ouvrir l'éditeur

Cliquez sur **Editor** dans la barre latérale du dashboard. L'éditeur s'ouvre sur le dépôt connecté et la branche par défaut de votre projet.

<Note>
L'éditeur nécessite un [dépôt GitHub connecté](/fr/setup/connecting-github) et un grand écran (ordinateur de bureau). Sur les fenêtres plus étroites, il affiche un message « navigateur plus large requis », car les volets de code et de preview ont besoin de place pour être côte à côte. Il est disponible pour tout propriétaire de projet et membre d'équipe, sur toutes les formules.
</Note>

## L'interface

L'éditeur comporte trois volets :

| Volet | Ce qu'il fait |
|------|--------------|
| **Navigation** (gauche) | Les pages et groupes de votre site, lus depuis `docs.json`. Filtrez les pages, ouvrez l'éditeur **Configuration** (`docs.json`), ou **Add page**. |
| **Editor** (centre) | Un éditeur de code MDX pour le fichier ouvert, avec coloration syntaxique et un compteur de mots. |
| **Preview** (droite) | Un rendu en direct de la page, mis à jour au fur et à mesure que vous tapez. Basculez entre **Desktop / Mobile** et **Light / Dark** pour vérifier le rendu. |

La branche que vous modifiez est affichée en haut à gauche ; changez de branche avec le sélecteur de branche.

## Modifier une page

Cliquez sur n'importe quelle page dans la navigation pour l'ouvrir. Modifiez le MDX dans le volet central et observez le preview se mettre à jour en direct. Vos modifications sont conservées comme brouillon local dans votre navigateur jusqu'à ce que vous commitiez — vous pouvez donc passer d'une page à l'autre sans perdre votre travail, et rien n'est écrit sur GitHub tant que vous ne choisissez pas de commiter.

## Ajouter une page

Cliquez sur **Add page** pour créer une nouvelle page sans quitter l'éditeur :

1. Choisissez un modèle de départ.
2. Saisissez un titre — le nom de fichier de la page en est dérivé automatiquement.
3. Choisissez le groupe de navigation auquel elle appartient.

La nouvelle page s'ouvre en tant que brouillon. Lorsque vous commitez, Jamdesk écrit à la fois le nouveau fichier `.mdx` et l'entrée de navigation dans `docs.json`, dans le même commit.

## Commiter les changements

Lorsque vous êtes prêt à publier, commitez vos changements en attente sur GitHub :

<Steps>
  <Step title="Ouvrir la boîte de dialogue de commit">
    Cliquez sur **Commit**. La boîte de dialogue liste tous les fichiers que vous avez modifiés (une page, `docs.json`, ou plusieurs à la fois).
  </Step>
  <Step title="Rédiger un message">
    Saisissez un message de commit, ou cliquez sur **Generate** pour que Jamdesk en rédige un à partir de votre diff.
  </Step>
  <Step title="Commiter">
    Jamdesk commite les changements sur votre branche actuelle et démarre immédiatement un build. Suivez-le sur la page **Builds** du projet.
  </Step>
</Steps>

Vous préférez plutôt annuler les modifications ? **Revert** annule les changements non enregistrés de la page actuelle et restaure la version commitée.

## Gérer les changements externes

Si quelqu'un d'autre pousse sur la même branche pendant que vous modifiez, l'éditeur remarque que la branche a bougé et le signale. Lorsque vous commitez, tout fichier modifié en amont est présenté sous forme de fusion à trois voies afin que vous puissiez réconcilier les deux versions — vos modifications locales ne sont jamais perdues.

<Tip>
Commiter depuis l'éditeur revient exactement à pousser depuis votre propre machine : cela écrit un vrai commit dans votre dépôt et déclenche le même pipeline de build. Si vos docs se trouvent dans un sous-répertoire du dépôt ([configuration monorepo](/fr/setup/monorepo-support)), l'éditeur y lit et y écrit automatiquement.
</Tip>

## Prérequis

| Prérequis | Détail |
|-------------|--------|
| **GitHub connecté** | Le projet doit avoir un dépôt et une branche connectés. |
| **Navigateur de bureau** | Un grand écran (environ 1400px et plus) ; l'éditeur n'est pas disponible sur les largeurs mobiles. |
| **Accès** | Tout propriétaire ou membre du projet. Modifier écrit dans votre dépôt, les verrous d'écriture habituels s'appliquent donc (par exemple un abonnement en retard de paiement). |

## Et ensuite ?

<Columns cols={2}>
  <Card title="Preview local" icon="eye" href="/fr/development/local-preview">
    Preview et modifiez en local avec le CLI
  </Card>
  <Card title="Comment fonctionne le déploiement" icon="rocket" href="/fr/deploy/lifecycle">
    Ce qui se passe après un commit
  </Card>
</Columns>