为 Visual Studio 中的 JavaScript 生成 javadoc

Generate javadoc for JavaScript in Visual Studio

我需要为一个 JavaScript 项目生成文档,我想用 Javadoc 来完成。

无奈,我必须在 Visual Studio 2013 年完成它,而且看起来没有什么可以帮助 Javadoc 注释块。我至少希望在执行此操作时: /** + enter 生成:

/**
 *
 */

我在 Whosebug 和 Microsoft 网站上寻找过插件或类似问题,但我只找到了 Doxygen 的插件或解决方案。

我真的在寻找不存在的东西,还是我错过了什么? (希望如此)

对于 Visual Studio,您可以使用 DocStubsJs,Visual Studio 2012+ 的扩展,为 JavaScript 和 TypeScript 编辑器中的 JSDoc 和 VSDoc 自动生成文档注释存根。

GitHub

上可用的源代码

引自 GitHub 自述文件:

DocStubsJs is a fairly straight-forward plugin that uses events and string parsing to determine when and how to insert a document stub. It essentially just watches key-strokes for the identifying documentation comment bock initializers. ("///" for VSDoc, and "/**" for JSDoc) Once it has determined that these have been entered on an empty line, then it parses the lines surrounding it to determine whether to add a new comment line, create a documentation comment stub, or do nothing.

注:

对于 JSDoc 注释,在函数头上方的行中键入“/**”后,将添加参数标签以及 return 标签。 (Web Essentials 用户请注意:您可能必须在 Web Essentials 的 JavaScript 选项中禁用多行注释的自动完成才能使其正常工作。)