javascript - 用于车把助手的 JSdoc doclet

Question

我为我正在构建的一个小型应用程序设置了 JSdoc。我最近也开始将 doclet 添加到我的车把助手文件中，但是我在正确注释模式时遇到了麻烦。

/**
 * My helper Name 
 * My helper description
 *
 * @method myHandlebarsHelper
 * @param options.hash.data {object} - some object
 * @param options.hash.param {string} - some string
 * @returns {string} some output string
 **/

另外，我想确保把手助手在文档输出中有自己的独立部分。目前，所有内容都输出到 Global 部分。我应该使用@namespace 还是@external 来完成此操作？

提前致谢

Answer 1

您可以使用@externals或另一种选择是记录一个（假）模块，即

/** @module handlebars */

在一个文件的顶部并记录所有帮助者成为该模块的成员。它在语法上不正确，但可以很好地分开。

同样，您可以使用命名空间

/** @namespace HandlebarsHelper */

并将所有成员记录为

/**
 * My helper Name 
 * My helper description
 *
 * @method HandlebarsHelper.myHandlebarsHelper
 * @param options.hash.data {object} - some object
 * @param options.hash.param {string} - some string
 * @returns {string} some output string
 **/