Quel module dois-je utiliser pour générer de la documentation ?

Bonjour,

Pour un module node, je souhaite expliquer comment l’utiliser (A) et détailler les prototypes des fonctions publiques (B).

Si c’est possible : J’aimerais pouvoir générer un CSS custom.

Besoin A

Pour expliquer mon module je souhaite faire un dossier ./doc/ avec des fichiers en mardkown où j’explique tout ce qu’il y a à savoir.

Besoin B

Ensuite, comme toute bonne doc qui se respecte j’ai besoin de détailler/lister les fonctions publiques, actuellement (je suis la norme de jsDOC), j’obtiens :

/**
 * create HTTP Server
 *
 * @param   {object}    app     Express app
 * @param   {number}    port    Port number
 */
Http.prototype.createHttpServer = function(app, port) {

Comment dois-je m’y prendre ? Quel choix j’ai si je veux que la mise en prod de la doc soit automatique lorsque je push ma branche master ?

Bon vol,

A.

J’ai vu gitbook qui est similaire à mdbook qui semble être conseillé par jsdoc.

@artragis: Normalement il y a jsdoc qui est la solution la plus apte.

En cherchant node documenting recommended, je suis tombé sur The best documentation generator for Node qui présente Docstrap pour styliser le rendu de jsdoc.

Ce que je cherche en faite, c’est que la publication soit automatique lors d’une PR comme pour le zds.

J’avais vu :

Deployment

I use Github Project Pages to deploy my documentation. There are several options here, but I use the gh-pages branch of my project to auto deploy it’s documentation. SideBar: You can also register your documentation site as a sub-domain of js.org. The basic process of deploying my docs is to push the content of the _book/ directory to the gh-pages branch of my project (using git).

Ce passage qui a retenu mon attention, je peux auto-publish sur github.io suite à une PR ?

oui, comme on fait avec zds en fait.

Je n’ai pas compris le passage du token secret

Comment je m’y prend pour créer une branche gh-pages vide ?

Une vrai catastrophe jsdoc + docdash, c’est de l’a peu près… (J’en suis déjà à 2 PR)

/**
 * Create the App Server with express.
 *
 * @name       AppExpress.createAppServer
 * @param      {eventEmitter}    eventEmitter     eventEmitter
 * @return     {Express}         Returns a new instance of Express.
 */
AppExpress.prototype.createAppServer = function(eventEmitter) {

Je suis obligé de forcer le nom avec AppExpress.createAppServer sinon j’ai AppExpress#createAppServer mais je perd le paramètre…

EDIT : Je dois forcer le truc avec : * @function