标签: documentationjs

在JSDoc生成的文档中对函数进行分组

我正在使用documentationjs(它使用jsdoc)来处理我正在处理的lib的文档生成.我的lib编写的是ES6并且功能齐全,目前生成的文档是lib中所有模块的所有函数的字母顺序列表.这使得很难找到你想要的东西.我应该如何使用jsdoc注释,以便将一个文件中的函数组合在一起?

例如,给定以下文件...

/**
 * Docs for alpha
 */
export const alpha = () {};

/**
 * Docs for beta
 */
export const beta = ()  {};

/**
 * Docs for charlie
 */
export const charlie = () {};
Run Code Online (Sandbox Code Playgroud)

...我应该如何使用jsdoc注释来确保三个函数在文档中的"示例"下组合在一起?

我已经尝试在类的顶部定义一个模块:/** @module Example */但是虽然这会在文档中生成一个名为"Example"的项目,但是函数不会在它下面进行分组.

我已经尝试添加@memberof Example各个函数的文档,但这没有任何效果.

我知道这个问题,但它对我不起作用,可能是因为ES6导入.@module文档中没有提及它的用法.

javascript comments jsdoc jsdoc3 documentationjs

7
推荐指数
1
解决办法
738
查看次数

标签 统计

comments ×1

documentationjs ×1

javascript ×1

jsdoc ×1

jsdoc3 ×1