Premiers pas avec l’éditeur web

Apprenez à créer et à modifier de la documentation avec l’éditeur web

L’éditeur web est une interface visuelle pour créer, modifier et relire votre documentation directement dans votre navigateur.

• Édition visuelle : Modifiez votre documentation avec un éditeur WYSIWYG (what you see is what you get) qui affiche le rendu final de votre contenu.
• Synchronisation Git : Toutes les modifications sont automatiquement synchronisées avec votre dépôt Git pour assurer le contrôle de version.
• Collaboration : Plusieurs personnes peuvent travailler simultanément sur la documentation.
• Intégration de composants : Ajoutez des encadrés, des blocs de code et d’autres composants avec des commandes slash.
• Aucune configuration requise : Commencez à écrire immédiatement depuis votre tableau de bord.

​

Flux de travail de l’Éditeur web

Voici comment vous travaillerez généralement dans l’Éditeur web :

1. Choisissez votre branche

   Créez une branche ou apportez des modifications directement sur votre branche de déploiement. Nous recommandons de créer une branche afin de pouvoir prévisualiser vos changements avant leur mise en ligne.

2. Ouvrez votre fichier

   Accédez à un fichier existant dans la barre latérale ou créez-en un nouveau à l’aide de l’explorateur de fichiers.

3. Modifiez votre contenu

   Modifiez votre contenu dans l’Éditeur web. Essayez d’alterner entre le mode visuel et le mode Markdown à l’aide du commutateur dans l’angle supérieur droit pour voir le mode que vous préférez.

4. Prévisualisez vos modifications

   Le mode visuel vous montre comment vos changements apparaîtront sur votre site en ligne. Utilisez-le pour vérifier que tout est correct.

5. Publiez vos modifications

   Si vous travaillez sur votre branche de déploiement, publiez vos changements directement depuis l’Éditeur web. Sur les autres branches, créez une pull request pour révision avant la publication.

​

Modes de l’éditeur

L’éditeur web propose deux modes pour s’adapter à différentes préférences et besoins d’édition. Utilisez l’interrupteur dans l’angle supérieur droit de la barre d’outils de l’éditeur pour passer d’un mode à l’autre.

​

Mode visuel

Le mode visuel offre une expérience WYSIWYG où les modifications effectuées dans l’éditeur sont exactement celles qui seront publiées sur votre site de documentation. Ce mode est idéal si vous souhaitez voir en temps réel le rendu de vos modifications.

Appuyez sur « / » pour ouvrir le menu contextuel des composants et ajouter du contenu stylisé, des encadrés, des extraits de code ou d’autres composants.

​

Mode Markdown

Le mode Markdown donne un accès direct au code MDX sous-jacent de votre documentation. Il est idéal lorsque vous avez besoin d’un contrôle précis des propriétés des composants ou lorsque vous préférez écrire en Markdown.

​

Prochaines étapes

• Apprenez les concepts Git fondamentaux.
• Découvrez les bonnes pratiques de collaboration avec les branches.
• Explorez la gestion de contenu avec l’Éditeur web.
• Familiarisez-vous avec les options de publication adaptées à différents scénarios.