JSDoc 3 介绍
jsDoc 3是一款根据 JavaScript 文件中注释信息，生成 JavaScript 应用、库、模块的 API 文档的工具。你可以使用它记录如：命名空间、类、方法、方法参数等。该项目还衍生出了许多模板和其他工具来帮助生成和自定义文档
安安装jsDoc
npm i jsdoc -g
如何使用jsDoc
同其他语言一样，文档生成工具的原理还是通过代码注释去解析并根据一定的tag来生成文档。在jsDoc文档中明确说明了，只有以/**为开始的注释才会被jsDoc识别，其他的注释格式都会被忽略。
额外，jsDoc 默认还会将项目中的README.md文件一同生成到jsDoc最后生成的文档文件中，或通过命令--R/-readme 指定个别文件，将其添加至所生成的文档文件中，但文件格式必须是Markdown，此时，项目中的README.md将被忽略。
jsDoc命令行参数
jsDoc命令行几个常用参数有以下几个：-c,--configure 指定configuration file-d,--destination 指定输出路径，默认./out-e,--encoding 设定encoding，默认utf8-p,--private 将private注释输出到文档，默认不输出-P,--package 指定package.json file-r,--recurse 查询子目录-t,--template 指定输出文档template-u,--tutorials 指定教程路径，默认无JSDoc配置文件
同许多js工具一样，JSDoc也有配置文件，可以通过设定配置文件来定制JSDoc。如果没有指定configuration file，将会使用一下配置。{"tags": {"allowUnkNownTags": true,// 允许使用自定义tag"dictionaries": ["jsdoc","closure"] // 定义tag集},"source": {"includePattern": ".+\.js(doc)?$",// 将以.js,.jsdoc结尾的文件作为源文件"excludePattern": "(^|\/|\\)_" // 忽略以_开头的文件夹及文件},"plugins": [],"templates": {"cLeverLinks": false,"monospaceLinks": false}}链接: http://www.fly63.com/nav/991GitHub:https://github.com/jsdoc3/jsdoc
JSDoc 3
官方网站：http://usejsdoc.org
版权声明：本文内容由互联网用户自发贡献，该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容， 请发送邮件至 [email protected] 举报，一经查实，本站将立刻删除。