Yes, en fait c’est une idée dont on avait déjà parlé avec @vincent il y a assez longtemps. Sphinx avait été choisi notamment pour sa capacité à générer beaucoup de formats de sortie différents, et les pages de manuel en font parties.
Ce qu’on avait pensé faire à ce moment-là, c’est de produire plusieurs pages afin d’éviter d’avoir une page géante, peut-être en reprenant les sections principales (genre club1-info, club1-services-membres, etc.), ou bien peut-être juste les services (genre club1-mail, club1-ssh, etc.). Pour ça il est possible d’utiliser l’option man_pages
de Sphinx.
Actuellement il est déjà possible de générer des pages de manuel assez simplement à partir du dépôt des sources de la doc, avec la commande make man
(ou bien juste make man/fr
pour uniquement produire le rendu français).
Un petit aperçu de ce à quoi pourrait ressembler la doc CLUB1 en page de manuel (ici dans Neovim) :
Il serait assez simple de générer ces pages au cours du build automatique, mais il faudra ensuite installer les pages au bon endroit sur le serveur. Une idée serait de customiser le MANPATH, pour ne pas avoir à donner les droits root
à l’utilisateur docs
. Ça serait à première vue assez facile à faire grâce au fichier de config /etc/manpath.config
.