mdBook : Page Accueil
La page Accueil d’un site Web mdBook est la première page mdBook disponible dans le sommaire mdBook du site mdBook.
Par exemple lorsque nous ouvrons l’adresse Web de ce livre,
sans préciser de page précise, la page mdBook qui s’affiche est :
https://apprendre-et-maitriser-mdbook.marcjestin.fr/introduction.html.
qui correspond au premier chapitre du sommaire mdBook : « Introduction ».
Nous pouvons nous servir de la première page mdBook du sommaire mdBook pour créer :
- une page Accueil comme nous avons l’habitude de faire sur des sites web ;
- une première de couverture comme pour un livre ;
- etc.
Créer une page Accueil
Nous pouvons créer une page Accueil si nous le souhaitons.
Il suffit d’ajouter un premier chapitre mdBook (généralement non-numéroté) au fichier SUMMARY.md.
Nous lui donnons le titre « Accueil » et nous l’associons avec une page mdBook que nous composons comme nous le souhaitons.
Par exemple :
[Accueil](/.accueil.md)
Ne pas créer de page Accueil
Nous pouvons ne pas créer de page Accueil.
La page envoyé au lecteur est la première page mdBook figurant dans le sommaire mdBook.
C’est le choix que j’ai fait ici, en quelque-sorte.
Index.html
Il existe bien un fichier index.html dans la structure des fichiers du site mdBook.
C’est ce que nous avons coutume d’appeler la page Accueil dans un site Web car c’est la page qui s’affiche par défaut si aucune adresse de page web n’est indiquée.
Ce fichier index.html se charge d’afficher la première page mdBook du sommaire mdBook dans le navigateur web du visiteur.
Risque de conflit ?
Si nous choisissons de créer une page Accueil en utilisant le nom index.md, comme ici :
[Accueil](./index.md)
mdBook le gère sans que cela ne crée de conflit avec son propre fichier index.html.