URL: https://linuxfr.org/users/gato/journaux/generer-des-cours-en-markdown-avec-mkdocs-et Title: générer des cours en Markdown avec Mkdocs-et Authors: gato Date: 2021年03月29日T09:39:27+02:00 License: CC By-SA Tags: markdown Score: 26 Bonjour, j'ai fait un petit outil pour générer sur une page web des cours écrits en Markdown : [Mkdocs-et][1] C'est basé sur le générateur de sites statique [Mkdocs][2] et le thème [Material for Mkdocs][3], et c'est en fait un gros script bash [^1] qui apporte quelques possibilités dont j'avais besoin : - faire apparaître progressivement les planches de cours, TD et TP (Mkdocs publie tout d'un coup) ; - s'installer tout seul dans un `virtualenv` avec les packages qui vont bien ; - avoir un truc déjà tout configuré sans avoir à relire toute la doc ; - publier le site avec un `rsync`, et d'autres bricoles (par exemple embarquer un bout de PHP pour publier des notes, voir l'[exemple][4]). Pour tester le script je me suis amusé à faire toute une doc, et quelques "cours" (Lectures) et "TP" (Practical Work) sur Markdown que l'on peut filtrer, c'est-à-dire publier partiellement (du cours 1 au cours x, du TP 1 au TP y). Tout le site est généré avec le script, et les sources sont dans le tarball téléchargeable. Bonne lecture... [^2] [1]: http://pageperso.lif.univ-mrs.fr/~edouard.thiel/mkdocs-et/ [2]: https://www.mkdocs.org/ [3]: https://squidfunk.github.io/mkdocs-material/ [4]: http://pageperso.lif.univ-mrs.fr/%7Eedouard.thiel/mkdocs-et/prw-03-php/ [^1]: Je viens de finir un gros cours d'administration Unix alors j'étais chaud ! [^2]: Des typos ou mauvaises tournures ont pu m'échapper, je vous remercie de me les signaler.