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 : Architecture des fichiers

Un projet mdbook se crée et vit sa vie dans un dossier local (je ne parle que de ce cas d'application dans ce Bloc-notes mdBook).

Lorsque nous validons la commande suivante en étant dans le dossier Nom-du-projet/

mdbook init

et que nous répondons au « y » à la première question (création d'un fichier .gitignore), mdBook crée une base de fichiers dans notre dossier Nom-du-projet/.

Note : mdBook ne tient pas compte du nom de projet que nous lui indiquons en réponse à la seconde question.

Le fichier de description et de paramétrage de notre projet mdBook est book.toml.

Les fichiers de création de contenu sont dans le dossier Nom-du-projet/src (par défaut).
C'est dans ce fichier book.toml que nous pouvons indiquer un autre emplacement si nous le souhaitons.

Lorsque, en étant dans le dossier Nom-du-projet/, nous construisons les fichiers destination avec la commande :

mdbook build

mdBook crée l'ensemble des fichiers et dossiers nécessaires à construction du site Web mdBoolk dans le dossier Nom-du-projet/book (par défaut).

Chargement du site sur un serveur externe

Si nous disposons d'un serveur Web externe, il suffit de copier le contenu du dossier Nom-du-projet/book dans un dossier correspondant à l'adresse que nous souhaitons donner à notre site Web mdBook par exemple dans le cas de ce site Web mdBook :

{mondossierweb}/happynumeric.fr/Bloc-notes-mdBook

Voilà pour le fonctionnement de base de mdBook.

Cela suffit pour créer un projet mdBook sur notre machine et le mettre en ligne sur le World Wide Web.

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

Dernière mise à jour : 22 mars 2023 15:32