是否可以在IDEA/WebStorm中一键生成JSDoc文档,就像我用IntelliJ IDEA做JavaDoc一样。
TL;DR:
![enter image description here](https://i.stack.imgur.com/KYSbY.png)
要将 JSDoc 文档生成功能添加到 IntelliJ IDEA / WebStorm:
-
Install jsdoc
到 Node.js 项目:npm i jsdoc
-
准备一个 JSDoc 配置文件(jsdoc.json
)并将其存储在项目的根目录中
-
Go to 文件 |设置|工具|外部工具在 IntelliJ IDEA / WebStorm 中
-
添加一个名为的新外部工具生成 JSDoc...组的文档.
-
In 工具设置提供以下参数:
-
Program:Node.js 二进制文件的路径,例如:C:\Program Files\nodejs\node.exe
-
论据: JSDoc 脚本和 JSDoc 配置的路径 (jsdoc.json
),例如:$ProjectFileDir$/node_modules/jsdoc/jsdoc.js -c $ProjectFileDir$/jsdoc.json
这里可以指定绝对路径或使用 IDE 的内部命令提供相对路径$ProjectFileDir$
-
工作目录: 源路径,例如:$ProjectFileDir$\src
-
Press OK and Apply
现在,前往工具 → 文档 → 生成 JSDoc...等等,JSDoc 是根据 JSDoc 配置生成并存储的(jsdoc.json
).
附:本指南在 IntelliJ IDEA 2021.2 上进行了测试。
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系:hwhale#tublm.com(使用前将#替换为@)