有两种方法可以将 README
文件中的信息合并到您的文档:
README.md
的Markdown文件的路径。JSDoc将使用在源路径中发现的第一个 README.md
文件。
使用-R/--readme
包命令行选项运行JSDoc,指定 README
文件的路径。此选项在JSDoc3.3.0及更高版本中可用。README
文件可以使用任何名称和扩展名,但它必须是Markdown格式。
-R/--readme
命令行选项优先于你的源路径。如果使用-R/--readme
命令行选项,JSDoc会忽略源路径中任何的README.md
文件。
如果您正在使用JSDoc的默认模板,README
文件的内容将渲染成HTML,生成在文档 index.html 文件中。
在源路径中包含一个 README 文件:
jsdoc path/to/js path/to/readme/README.md
使用 -R/--readme 选项:
jsdoc --readme path/to/readme/README path/to/js