Désactiver la fonction impression du livre

Par « impression du livre », nous entendons :

• la génération d’un fichier https://adresse-du-site/print.html
• qui permet l’impression du livre mdBook complet. ¹

Bonne nouvelle : c’est prévu !

Pour désactiver cette fonction sans effort, il suffit d’ajouter cette ligne de configuration dans book.toml:

output.html.print.enable = false

Pour la réactiver, nous pouvons retirer la ligne (la valeur par défaut étant à true) ou la modifier pour avoir

output.html.print.enable = true

Dommage que ce ne soit pas dans book.toml dès le début

Parmi les défauts de mdBook figure le fait qu’ils ont choisi de simplifier le fichier book.toml par défaut : ce fichier est presque vide lors de la création d’un nouveau projet.

Il n’apporte aucune valeur ajoutée.

Pour ma part, je préfère les fichiers comme on a l’habitude d’en voir dans des projets tout à fait comparables et sérieux dans lesquels tous les paramètres, ou tout du moins les paramètres essentiels, figurent dans le fichier, soit avec leur valeur par défaut, soit sous forme de commentaire documentation.

Lorsque ces fichiers sont bien faits, ils sont documentés pour décrire le rôle du paramètre et les actions ou valeurs possibles et recommandées.

Cela permet :

• lorsque la documentation est bien faite, d’apprendre plus vite des choses essentielles ;
• lorsque la documentation est bien faite, de ne pas avoir besoin d’aller chercher ailleurs le « pour quoi c’est faire » ;
• de faciliter et d’accélérer le paramétrage complet adapté à nos attentes et besoins et
• de repérer des paramètres auxquels nous n’aurions pas nécessairement pensé.

Il n’est pas bien difficile de mettre tous les paramètres de configuration de base comme celui-ci dans le fichier book.toml généré lors de la création d’un projet mdBook.

C’est juste une question d’attitude : se mettre résolument au service de l’utilisateur·trice.

1. L’impression ou la génération d’un fichier PDF qui contient l’ensemble du contenu du site web mdBook.
   Pour préserver la planète, limitons nos impressions physiques au strict minimum ! ↩