Navigation

Inscrivez-vous gratuitement
pour pouvoir participer, suivre les réponses en temps réel, voter pour les messages, poser vos propres questions et recevoir la newsletter

  1. #1
    Membre régulier
    Documentez vos librairies JavaScript comme des pros !
    Comme je n'ai pas trouvé, sur le forum, de références faites à un petit logiciel que j'utilise pour générer de la documentation sur mes libraires JavaScript, je vous fais part ici de ma découverte.

    Il s'agit de JSDcoc. JSDoc est un simple script programmé en Perl qui procède de la même manière et avec les mêmes méthodes que JavaDoc, bien connu des développeurs Java. JSDoc génère une documentation d'allure professionnelle en une seule étape qui dure une fraction de seconde.

    La doc est générée à partir du code et des commentaires contenus dans vos fichiers JS. Comme le logiciel est écrit en Perl, il peut être installé sur tous les systèmes d'exploitation qui supportent Perl (Linux, Unix, Windows, MacOS ?)...

    Voici un exemple généré avec JSDoc dans un petit projet récent : Cliquez ici.

    Amusez-vous bien !

  2. #2
    Membre expert
    Cool merci du tuyau !

    Petite remarque en passant : il y a juste un petit problème au niveau des dates

    Version: 1.2 (24/30/2005)
    Je plaisante, bien entendu...
    K

  3. #3
    Membre régulier


    B'en ça alors !!

  4. #4
    Expert éminent
    Re: Documentez vos librairies JavaScript comme des pros !
    Citation Envoyé par Claude Pelletier
    Comme je n'ai pas trouvé, sur le forum, de références faites à un petit logiciel que j'utilise pour générer de la documentation sur mes libraires JavaScript, je vous fais part ici de ma découverte.
    Merci pour ta contribution, mais pour le principe, je me dois de te montrer qu'on en a déjà parlé : http://www.developpez.net/forums/vie...ighlight=jsdoc.

    Après, tu peux me dire que je fais vraiment du mauvais esprit, parceque cette remarque est vraiment pas très visible , ok, je


  5. #5
    Membre régulier
    La recherche par mot clef ne m'avait rien donné. Cela dit, un petit rappel de l'existence de ce bel outil n'est pas superflu.

###raw>template_hook.ano_emploi###