documentation-generation - 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) {
...
}

Javascript 用のhttp://yardoc.orgのようなものを探しています。

お勧めできるツールは？Google Closure コード用の特定のツールはありますか?

Answer 1

その形式は「JsDoc」と呼ばれます。http://code.google.com/p/jsdoc-toolkit/を使用して、JsDoc アノテーション付き JavaScript から HTML に変換できます。