16得票1回答
直接从源代码生成JavaScript文档

我正在寻找一种工具,即使没有适当格式的注释块与这些函数或属性相关联(像Doxygen一样),也可以生成JavaScript函数和属性的文档。 这篇关于JSDoc和其他文档工具的比较的文章提到,JSDoc可以解析源代码以生成文档,即使没有注释块(就像我上面提到的Doxygen一样)。他们说所有...

15得票3回答
JavaScript + JsDoc:如何记录新的ES6数据类型,如map?

我正在尝试在我的ES6项目中使用JSDoc,我正在返回一个Map:/** * Some documentation.. * * @returns {undefined} <- This should be replaced */ function returningMap() ...

15得票2回答
如何在Ubuntu上对整个目录运行jsdoc

我只需要在包含.js文件的整个目录上运行jsdoc。我在Ubuntu终端上通过发出命令jsdoc abc.js 在单个文件上执行此操作,但我需要一次将此命令应用于目录中的所有文件,以便该目录中包含js文件的所有文件都会生成单个命令。感谢您提供的任何帮助。

13得票4回答
TypeScript会剥离注释并破坏JSDoc文档。

目标是从TypeScript代码获取JSDoc文档。TypeDoc(TypeScript文档解决方案)的文档质量不可接受,因为该文档针对的是JS用户,不应淹没特定于TypeScript实现的细节(接口等)。当前,将TypeScript编译成ES6并从JS文件生成文档基本可以解决问题。但未分配值...

13得票3回答
JSDoc:在另一个@param中引用方法的参考

我是新手,正在学习使用JSDocs,但找不到答案。假设我想编写这个简单的函数:function hasQ(array, item) {return array.includes(item);} 使用 JSDoc,我会进行标记,如下:/** * Another way to call array...

13得票1回答
jsdoc - 可以重复使用多个函数的文档吗?

我有一个带有大量选项的函数:/** * Show dialog in a blocking manner. * * @param {object} opts * @param {string} opts.msg "Body" of the dialog. * @param {numb...

13得票2回答
如何从JSON模式创建JSDoc类型

我有很多适用于Node.js项目的JSON模式。我能以任何方式使用它们来: 从“.js”代码文件中访问它们作为jsdoc类型,以提高webstorm智能感知的准确性 或者自动创建jsdoc类型定义 吗?

13得票1回答
jsdoc错误信息:“没有要处理的输入文件”

已经本地安装了 Jsdoc (npm install jsdoc)。我尝试执行以下命令时出现以下错误: .\node_modules.bin\jsdoc --debug ./lib/JavaScriptSource.js 输出如下: DEBUG: JSDoc 3.3.0-dev (...

12得票2回答
在JSDoc中描述对象数组

我有一个函数,它接受一个对象数组。 看起来像这样。myAwesomeFunction([ { name: 'someName', next: false, test: 'test' }, { name: '...

12得票3回答
能否使用JS Doc生成PDF文件?

我正在使用JS Doc 3版本(https://github.com/jsdoc3/jsdoc)。运行该工具时,默认情况下会生成HTML格式的文档。是否可以生成PDF格式的文档?