包含Package文件

包文件包含的信息对你的项目文档是很有用的，比如该项目的名称和版本号。当JSDoc生成的文档的时候,可以自动使用项目中package.json文件中的信息。例如，默认的模板在文档中显示项目的名称和版本号。

有两种方法可以将package.json文件中的信息合并到您的文档：

1. 在你的JavaScript文件的源路径中，包含package.json文件的路径。JSDoc将使用在源路径中发现的第一个package.json 文件。
2. 使用-P/--package 包命令行选项运行JSDoc，指定package.json文件的路径。此选项在JSDoc3.3.0及更高版本中可用。

-P/--package 命令行选项优先于你的源路径。如果使用-P/--package 命令行选项，JSDoc会忽略源路径中任何的package.json文件。

package.json 文件必须使用 npm's 包格式.

示例

jsdoc path/to/js path/to/package/package.json

jsdoc --package path/to/package/package-docs.json path/to/js