 réaliser de la documentation avec docutils et ou sphinx doctutils est une suite d outils permettant la transformation d un texte intéligible grâce à une syntaxe qui lui est propre en plusieurs formats tels que le html ou le latex la syntaxe utilisée est le restructuredtext que l on écrit aussi rest installation le nom du paquet à installer est pythondocutils à adapter en fonction de votre distribution gnu linux urpmi pythondocutils edition  mkdir doc cd doc prenez votre éditeur de prédilection vim essaitxt essai de titre soustitre bla bla liste 1 item 2 item 3 deuxième soustitre bla bla ls tmp cd usr bin pour créer un titre souligner le avec le caractère de votre choix pour faire un soustitre souligner le avec un autre caractère de votre choix pour faire une liste utiliser simplement des tirets pour créer un bloc utiliser suivit du contenu avec un retrait il est possible d exporter votre travail vers html man odt pseudoxml xml latex et s5 vim est en mesure d apporter la coloration syntaxique pour l y aider vous pouvez donner l extension rst plutôt que txt exporter nous pouvons maintenant exporter notre document dans le format html rst2html essaitxt essaihtml vous pouvez maintenant visualiser le résultat dans votre navigateur firefox essaihtml voici d autres balises pour docutils  http docutilssourceforgenet sandbox wilk french quickstartfrhtml essayons maintenant avec sphinx c est un outil de génération de documentation pour les projet python installation  urpmi pythonsphinx liens site de docutils  http docutilssourceforgenet  le guide de démarrage rapide de rst  http docutilssourceforgenet docs user rst quickrefhtml  logiciels  