前言
在前端开发中，文档非常重要，特别是当多人协作或者是需要维护老项目时，一份清晰完整的文档可以帮助开发人员快速的理解和维护代码，也大大提高了工作效率。而 esdoc 是一个非常优秀的 JavaScript 文档生成工具，本文将介绍如何使用 npm 包 esdoc-ineject-script-plugin 可以将一个 JavaScript 文件内置到 esdoc 生成的文档中。
安装
使用 npm 安装 esdoc-ineject-script-plugin：
npm install esdoc-ineject-script-plugin --save-dev
配置
在 esdoc.json 文件中添加如下配置项：
{
"plugins": [
{"name": "esdoc-ineject-script-plugin", "option": { "files": ["path/to/my-script.js"] }}
]
}其中 "path/to/my-script.js" 为要内置的 JavaScript 文件的路径。
示例代码
以下是在一个 index.js 文件中引用 jQuery 并使用 esdoc-ineject-script-plugin 插件生成的示例代码：
-- -------------------- ---- -------
---
- ----- --------
- ----- ----- ------ -----
--
---
- -- ------ - ---- --
- ------ -------- --- - ----
- -------- --------- ------- --
--
-------- ------------ -
------ ------------
-
-- ---- ----- ----
------------------------ ---------- -
-- ------
----------------------------------------------------------- -
-- -------
------------
---
--在使用 esdoc-ineject-script-plugin 插件之前，运行使用 esdoc 生成的文档将不会包含 jQuery 相关的文档，而且在文本编辑器中使用自动完成或者 code intelligence 时也无法识别 $ 为 jQuery 对象。但是使用插件之后，生成的文档将包含 path/to/my-script.js 文件的文档和 $ 对象的类型定义。生成的文档可以通过访问 ./esdoc/index.html 文件进行查看。
总结
esdoc-ineject-script-plugin 插件使得我们可以将一个 JavaScript 文件内置到 esdoc 生成的文档中，从而方便我们的文档编写和维护。希望本文可以帮助到需要使用 esdoc 生成文档的前端开发人员。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/6005588d81e8991b448d5d0b