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 : Markdown : mise en garde
Il peut exister des variantes dans les langages Markdown.
Je ne les présente pas toutes ici.
Markdown par défaut
Je recommande de nous attacher à utiliser les codes recommandés par mdBook lorsque nous travaillons avec mdBook.
Dans sa documentation officielle, mdBook renvoie actuellement vers la « GitHub Flavored Markdown Spec » (spécification MarkDown saveur Github) 1.
À ce jour (20 mars 2023), il s'agit de la v 0.29 gfm (2019-04-06).
Cela ne garantit en rien que le compilateur mdBook est 100 % compatible avec l'intégralité de ce document.
Il est préférable de nous en tenir aux codes et méthodes documentés dans la documentation officielle pour ne pas nous exposer à d'éventuelles difficultés par la suite lors d'une montée de version par exemple.
En effet, la plupart des tests fonctionnels qui sont faits le sont d'abord et avant tout avec les pratiques de la communauté mdBook.
Il est bon d'avoir connaissance des conventions et pratiques autres, mais nous devrions avoir conscience et nous attacher à nous en tenir à celles de l'outil.
J'ai créé ce bloc-notes mdBook en me référant aux documentations et autres supports mdBook officiels.
Vous ne devriez pas rencontrer de difficultés particulières si vous suivez les indications que j'y donne.
Rester homogène
Lorsque plusieurs symboles sont possibles, le fait de les mélanger n'est pas une bonne idée.
Si nous écrivons nos fichiers sources en mélangeant les symboles, nous risquons d'obtenir de mauvais résultats ou de perdre des contenus dans le projet mdBook une fois compilé.
Par exemple, avec ce type d'écriture :
- [mdBook : Fonctions avancées]()
- [mdBook : serve : visualiser nos modifications en continu](./mdbook-serve-visualiser-nos-modifications-en-continu.md)
* [mdBook : renommage d'une page](./mdbook-renommage-d-une-page.md)
le compilateur mdBook génère un sommaire qui élude un des deux sous-chapitres de sommaire mdBook.
Dommage !
En principe, nous n'avons pas de problème si nous définissons correctement et respectons des conventions de codage.
Ces Conventions de codage devraient être rédigées par des personnes compétentes de manière suffisamment claire pour être appliquées à la lettre et sans le moindre malentendu par des personnes moins expertes.
Ce bloc-notes mdBook vous est proposé par Marc JESTIN — Happy Numeric. |
Formation, rédaction de documentations techniques ou organisationnelles, mise en place de solutions documentaires internes et externes, assistance à maîtrise d'ouvrage, etc. |
Contact : https://happynumeric.fr/me-contacter |
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 : 23 mars 2023 21:16
1 GitHub Flavored Markdown Spec (anglais) : https://github.github.com/gfm/