node.js - JSDoc:如何包含多个 .md 文件
问题描述
这是我第一次被要求编写文档,我选择的方法是使用 jsdoc。
以下是我的 jsdoc 的示例 jsdoc.json 配置文件。它只读取一个 README.md 文件。
{
"source": {
"include": "./client/src",
"includePattern": ".js$",
"excludePattern": "(node_modules/|docs)"
},
"plugins": ["plugins/markdown"],
"templates": {
"cleverLinks": true,
"monospaceLinks": true,
},
"opts": {
"recurse": true,
"destination": "./docs/",
"readme": "./README.md"
}
}
如果我有 index.md 和 content.md,如何让它读取多个 .md 文件?
解决方案
我只是想做同样的功能,我发现的方法并不完美,但效果很好。在 JSDOC 中有一个称为“教程”的功能。
我所做的是在我的项目文件夹“Tutorials”的根目录中创建并添加到我的配置文件中的“opts”部分中:
"opts": {
"tutorials": "./Tutorials",
}
在 tutorials 文件夹中,您可以根据需要创建任意数量的 .md 文件,请记住,每个教程都需要具有唯一的名称。
每次您想将某些内容与特定教程(例如名为“content.md”的教程)联系起来时,您需要输入
{@tutorial content}
这适用于 Readme.md 和您拥有文档的任何 js 文件。您也可以将一个教程与另一个教程联系起来。
您可以在此处了解有关该功能的更多信息:
https://jsdoc.app/about-tutorials.html
https://jsdoc.app/tags-inline-tutorial.html
我的回答有点晚了,但我希望这至少可以帮助你未来的项目:)
推荐阅读
- reactjs - 正确设置 React 应用程序以与 VS Code 中的其他开发人员一起工作
- python - 根据 django 中的组选择列表显示人员列表
- android - 约束布局版本 > 2.0.1 不遵循公会规则
- python - 初学者问题:过滤日期以匹配 Django 中另一个模型的日期
- javascript - 访问 b-table 槽中的父组件范围
- html - 如何使用 ajax 向 Spring 控制器发送 post 请求
- python - 获取 Voronoi 图中特定点对应区域的面积
- javascript - 如何将元素的 NamedNodeMap 克隆为空对象?
- latex - 获得奇怪的表格形式
- c# - 工具提示文本离开屏幕 (WinForms)