Mkdocs

guillaume22 · 27-04-2015 08:03:21

Bonjour,
j'ai découvert ce script python qui est pour moi une petite perle que je voudrais faire partager.
C'est un générateur de site statique plus pour les documentations écrit en python, installable donc par pip et dont les pages sont écrits en markdown (plus facile que le html)
Il peut être appliqué à des sites de type wiki perso. Je l'utilise pour mettre mes données que j'avais sur dokuwiki qui nécessitait des maj et un serveur php et j'avoue que si je peux me passer de cela, c'est d'autant mieux. Bref pas mal d'avantages.

Les explications sont faciles à comprendre sur leur site mkdocs.org. Je rajouterai un truc, mkdocs propose de faire un serveur pour voir les changements, je trouve que cette fonctionnalité est assez lente si gros fichiers et qu'il est plus facile de créer le site avec mkdocs build --clean (quand on le fait plein de fois) et de visualiser le résultat.

Bonne journée

paskal · 27-04-2015 19:32:17

Bonsoir guillaume22

Un p'tit lien, peut-être ?

bendia · 27-04-2015 19:57:34

Coupler avec git comme cela, ça doit être pas mal

guillaume22 · 27-04-2015 20:08:55

J'ai un peu zappé. Voila
www.mkdocs.org

Git j'ai découvert aussi cela récemment, c'est génial. Je l'utilise surtout pour mes sketchs arduino et l'élaboration de bibliothèque, avec des dépôts framasoft. J'envisage de mettre un dépôt sur mon rpi d'ailleurs.

paskal · 27-04-2015 20:15:26

Debian-facile

#1 27-04-2015 08:03:21

Mkdocs

#2 27-04-2015 19:32:17

Re : Mkdocs

#3 27-04-2015 19:57:34

Re : Mkdocs

#4 27-04-2015 20:08:55

Re : Mkdocs

#5 27-04-2015 20:15:26

Re : Mkdocs

Pied de page des forums