Ce bloc-notes mdBook vous est proposé avec passion par Marc JESTIN — Happy Numeric.
À votre service pour vous accompagner dans vos projets numériques.
Contact : https://happynumeric.fr/me-contacter.

mdBook serve : visualiser nos modifications en continu

mdBook propose un outil qui fournit un service pour visualiser nos modifications en continu sur notre machine de travail : mdBook serve.

mdBook serve :

• surveille nos modifications des fichiers.md (lorsque nous les enregistrons) ;
• fournit un serveur Web intégré (d'où son nom) ;
• affiche automatiquement la nouvelle version des pages mdbook ouvertes dans notre navigateur Web si des modifications ont été enregistrées sans que nous ayons besoin de faire quoique ce soit.

Commande de base

La commande de base, à saisir dans le dossier Nom-du-projet/ est :

mdbook serve

Par défaut, nous accédons au serveur Web intégré correspondant en nous rendant à l'adresse :

https://localhost:3000

Commande avec ouverture du navigateur Web

L'option --open ou simplement -o ouvre la visualisation du livre dans notre navigateur Web par défaut :

mdbook serve -o

Indiquer un autre port

En cas de besoin, nous pouvons travailler sur un autre port grâce à l'option -p numdeport, par exemple :

mdbook serve -o -p 5555

Est-il obligatoire d'utiliser mdbook serve ?

Nous pouvons ne pas utiliser mdbook serve.

Nous utilisons alors la commande :

mdbook build

pour compiler notre projet mdBook.

Nous pouvons alors visualiser un aperçu du site Web mdBook en ouvrant les fichiers du dossier Nom-du-projet/book (par défaut) dans notre navigateur Web.

Certains composants ne fonctionnent pas comme dans la version Web de notre projet mdBook.

C'est bien plus pratique avec mdbook serve qui nous fait gagner beaucoup de temps, surtout si nous savons écrire et utiliser des scripts.

N'hésitez pas à me faire votre feedback, me signaler des erreurs ou des compléments que vous souhaiteriez que j'ajoute à ce bloc-notes mdBook.
Cliquez ici pour me contacter

À propos de cette page

Création : 19 mars 2023

Dernière mise à jour : 23 mars 2023 20:30