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 : Utilisation avancée

Travailler sur plusieurs projets mdBook simultanément

Si nous travaillons sur plusieurs projets simultanément, nous pouvons leur attribuer des numéros de port différents avec l'option -p numdeport.

Nous pouvons par exemple valider cette commande en nous plaçant dans le dossier du projet mdBook 1 :

mdbook serve -o -p 7777

et, une fois dans le dossier du projet mdBook 2, valider la commande :

mdbook serve -o -p 7778

Nous accédons alors aux sites Web mdBook correspondants en local avec les deux adresses :

https://localhost:7777
https://localhost:7778

Optimisation avec un petit script shell

Voici un exemple de script shell que nous pouvons ajouter dans notre dossier ~/bin.

Le script démarre les services mdbook serve et ouvre une fenêtre de notre navigateur Web sur chacun des deux sites Web mdBook.

Nous en profitons pour lui faire ouvrir notre gestionnaire de fichiers (ici nautilus de GNOME) directement dans des deux dossiers sources où nous devons intervenir.

cd ~/mdbooks/projet-mdBook-1/
mdbook serve -o -p 7777 &
cd ~/mdbooks/projet-mdBook-2/
mdbook serve -o -p 7778 &

nautilus ~/mdbooks/projet-mdBook-1/src &
nautilus ~/mdbooks/projet-mdBook-2/src &

Rassembler les fenêtres du navigateur Web

Si notre navigateur Web par défaut est Mozilla Firefox, nous pouvons utiliser l'extension Merge Windows : https://addons.mozilla.org/fr/firefox/addon/merge-window.

Pour nous en servir, nous cliquons sur le bouton droit dans une fenêtre de Mozilla Firefox puis sur le menu contextuel Merge all windows.

Toutes les fenêtres Mozilla Firefox ouvertes sont alors rassemblées sous forme d'onglets dans la même fenêtre.

Fermeture des services

Sous Linux, lorsque nous avons terminé de travailler sur nos projets mdBook, un simple killall mdbook ferme toutes les instances mdbook serve en cours d'exécution.

Si tant est que nous en ayons besoin (mdbook serve consomme peu de ressources systèmes).

Transférer les contenus avec un script shell

De même, nous pouvons écrire un script shell pour charger les nouvelles versions sur notre serveur Web.


Ce bloc-notes mdBook vous est proposé par Marc JESTIN — Happy Numeric.
Formation, rédaction de documentations techniques ou organisationnelles, mise en place de solutions documentaires internes et externes, assistance à maîtrise d'ouvrage, etc.
Contact : https://happynumeric.fr/me-contacter

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 22:14