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 : la compilation (build)

mdBook fonctionne sur un principe de compilation (build en anglais).

Le compilateur mdBook (mdBook builder) analyse et interprète les fichiers sources mdBook pour construire un site Web mdBook.

Pour voir le résultat d'un travail d'écriture, il nous faut effectuer une compilation via la commande :

mdbook build

Nous lançons cette commande depuis un Terminal en étant dans le dossier Nom-du-projet/.

mdBook utilise notamment le fichier book.toml ainsi que le contenu du dossier source afin de créer le site mdBook dans le dossier destination.

Le dossier source est le dossier Nom-du-projet/src (par défaut).

Le dossier destination est le dossier Nom-du-projet/book (par défaut).

Mise en garde importante

Le compilateur mdBook efface et recrée l'ensemble des fichiers et sous-dossiers destinations à chaque compilation.

Nous n'avons pas à intervenir dans le dossier Nom-du-projet/book.

Si nous souhaitons ajouter des fichiers au site Web mdBook, nous le faisons dans le dossier source.

Voir les méthodes décrites dans :

• mdBook : Markdown : Insertion d'images ;
• mdBook : Insérer un contenu dans une page mdBook.

Autres usages du compilateur

Le compilateur crée les sous-dossiers et fichiers.md définis dans SUMMARY.md et dans les pages mdBook s'ils n'existent pas.

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 : 17 mars 2023

Dernière mise à jour : 20 mars 2023 19:25