mdBook : lacunes du compilateur

Astuce : il peut arriver que des captures d’écran soient peu lisibles.
Pour voir les images correctement, cliquez bouton droit puis ouvrez les dans un nouvel onglet.

mdBook : erreur : include : Fichier manquant

Lorsque le préprocesseur de mdBook analyse les fichiers, il peut arriver qu’il trouve une consigne {{ #include }} qui indique une adresse de fichier incorrect.

Dans un tel cas, il indique une erreur comme suit :

Il n’indique pas pour quel fichier source cette erreur est générée.

mdBook : avertissement : include dans un bloc code : Fichier manquant

Si, comme c’est le cas dans ce livre, nous mettons un exemple de {{ #include }}, dans un bloc code, avec une adresse de fichier qui n’existe pas dans notre projet, le pré-processeur indique une erreur suivie d’unn avertissement comme ceci :

En principe, cet {{ #include }} ne devrait pas être interprété ou analysé par le préprocesseur mdBook puisqu’il est à l’intérieur d’un bloc code.

Cela n’est pas trop gênant dans la mesure où cela ne bloque pas la compilation, mais c’est très perturbant.

Ces lacunes identifiées en mars 2023 sont toujours d’actualité en juillet 2026.