Discussion :

[rolandcire]

Bonjour,

Je souhaite pouvoir générer une documentation à partir des commentaires insérés dans le code. Je cherche donc un outil de génération automatique...

En Php, il existe par exemple phpDocumentor (http://www.phpdoc.org/) qui va très bien. Je ne parviens pas à trouver un équivalent en javascript.

- J'ai tenté sans succès des outils qui m'ont demandé d'installer Perl auquel je ne connais rien : NaturalDocs (http://www.naturaldocs.org/), jsdoc (http://jsdoc.sourceforge.net/) ou l'excellent Doxygen (mais sa customisation pour Javascript me laisse en échec)
- J'ai tenté jsdoc-toolkit (http://jsdoctoolkit.org/) qui lui demande de fonctionner en Java en ligne de commande (je n'y arrive pas car cela est très loin de ma culture informatique actuelle)
- J'ai tenté la version d'évaluation de "Doc_O_Matic". Cela n'est pas terrible.

Bref, vous l'aurez compris, je suis désespérément à la recherche d'un soft sous Windows permettant de générer aisément de la documentation à partir du code (le style JavaDoc me va très bien).

Par avance merce de vos lumières...
Roalnd Cire

[SpaceFrog]

UN peu plus fastidieux poru en tirer une doc masi ça devrait te convenir

http://jgrouse.com/#main.html

[rolandcire]

Un grand merci pour cette réponse

Je l'avais vu dans mes pérégrinations... Mais je ne sais comment m'en servir.. Je ne me vois pas me lancer dans du Java... Je suis un autodidacte et mes connaissances se limitent à l'univers du Web classique (Php, Javascript, ActionScript...) en environnement Windows. Par effort successif, je passe peu à peu à une programmation objet que je cherche à bien documenter...

Malheureusement, je ne me vois pas me lancer pour l'instant dans un autre univers (Java par exemple)

Une autre idée ?

Merci

[SpaceFrog]

Heu pourquoi aurais tu besoin de te lancer dans java pour tout ces utilitaires ???

[rolandcire]

Merci

Bon, je crois qu'il faut que je retourne voir
http://jgrouse.com/#main.html

[DoubleU]

Apparemment jgrouse nécessite d'utiliser ANT... je suis pas sur que ca soit le plus simple pour un néophyte ^^

Même s'il est en java, l'utilisation de JsDoc ne me parrait pas insurmontable par contre.