Google Closure Javascript的文檔生成器

Question

我想爲我的Javascript代碼生成一個HTML文檔。 我的代碼中的註釋是以格式編寫的，Google Closure Compiler可以使用它來優化我的代碼。

例子：

/** 
* Class for handling timing events. 
* 
* @param {number=} opt_interval Number of ms between ticks (Default: 1ms). 
* @param {Object=} opt_timerObject An object that has setTimeout, setInterval, 
*  clearTimeout and clearInterval (eg Window). 
* @constructor 
* @extends {goog.events.EventTarget} 
*/ 
goog.Timer = function(opt_interval, opt_timerObject) { 
... 
} 

我在尋找類似http://yardoc.org爲Javascript。

您可以推薦哪些工具？ Google Closure代碼是否有特定的工具？

Answer 1

該格式被稱爲「JsDoc」。您可以使用http://code.google.com/p/jsdoc-toolkit/

Answer 2

更好的方法是使用最新版本（3.2.0）https://github.com/jsdoc3/jsdoc 據瞭解，幾乎所有封閉的註解從JsDoc標註的javascript轉換爲HTML。我將它用於http://estejs.com文檔。