2013-03-01 11 views
7

Mam projekt Backbone boilerplate opartego, że chcę, aby dokument z niedawnym jdoc-toolkitJak mogę udokumentować AMD projekt + szkieletowej z JSDoc3

Chociaż nie mogę zmusić go do wygenerowania niczego poza pustym _global klasy

przykładowy kod:

/** 
* This is a root model for DLClass 
* @module models/DLClass 
*/ 
define([ 
    'underscore', 
    'backbone' 
], /** @lends DLClass */ function (_, Backbone) {   
    /** 
    * This is a root model for DLClass 
    * @class DLClass 
    * @constructor 
    * @return Session Object 
    */ 
    var DLModel = Backbone.Model.extend({ 
     /** @lends DLClass.prototype */ 

    /** 
    * Generic tap event 
    * @param touchEvent 
    */ 
    onTap: function (touchEvent) { 

    }, 
+0

Nie możesz rozważyć to strasznie pomocny sugestia, ale może warto rozważyć, że można uzyskać wszystkie lub prawie wszystkie z pożądanych korzyści używając tylko JSDoc sposób już jesteś i nigdy generowania plików dokumentacji. Twoi programiści powinni mieć pełną zdolność do czytania dokumentacji wewnątrz plików .js, bez potrzeby generowania kodu HTML, przez co całkowicie unikniesz problemu z tym pytaniem. – machineghost

Odpowiedz

3

spróbuj dodać @namespace pozwolić JSDoc wiedzieć, aby przejrzeć zawartość modułu. I zdefiniuj swój moduł i jego funkcje za pomocą @name.

/** 
* This is a root model for DLClass 
* @module models/DLClass 
* @namespace 
*/ 
define([ 
    'underscore', 
    'backbone' 
], /** @lends DLClass */ function (_, Backbone) {   
    /** 
    * This is a root model for DLClass 
    * @class DLClass 
    * @module models/DLClass 
    * @name DLClass 
    * @constructor 
    * @return Session Object 
    */ 
    var DLModel = Backbone.Model.extend({ 
     /** @lends DLClass.prototype */ 

     /** 
     * Generic tap event 
     * @name DLClass.onTap 
     * @function 
     * @param touchEvent 
     */ 
     onTap: function (touchEvent) { 

     }, 
Powiązane problemy