随着前端开发的发展，各种工具、框架和技术层出不穷。其中一个核心的工具就是 npm 包管理工具，它能够帮助我们快速便捷地添加依赖、管理版本、打包部署等等。本篇文章主要介绍一款跟前端文档相关的 npm 包——egjs-jsdoc-template，它能够生成美观且易懂的文档，帮助我们更好地组织和理解代码。
什么是 egjs-jsdoc-template
egjs-jsdoc-template 是基于 jsdoc 和 handlebars 的模板系统，用于生成漂亮的文档。它支持类、方法、参数、对象、模块等多种类型的文档。同时，使用者也可以比较灵活地自定义模板。
使用 egjs-jsdoc-template 可以让我们更方便地生成并管理文档，同时还可以提高我们的代码阅读体验。
安装
首先，我们需要在项目中安装 egjs-jsdoc-template：
npm install egjs-jsdoc-template --save-dev
接着，我们需要在项目中安装 jsdoc：
npm install jsdoc --save-dev
使用
安装完成后，我们需要在我们的项目中添加配置文件.jsdocrc.json，示例如下：
-- -------------------- ---- -------
-
--------- -
---------- --------
----------------- -------------------
----------------- ---------------
--
---------- -
------------------
--
------------ -
-------------- ------
----------------- ------
------------- -------------
-------------------- -----
------------- --- ---------
--------- ---
--------------------- ---
---------- -
-------------------- ----
--
------- -------------------------------------
-------- -------
----------- -----
------------------ ------
------------- -----
-
-说明：
- "source" 部分定义了文档源文件的文件夹和文件类型。
- "plugins" 部分定义了使用 markdown 语法。
- "templates" 部分定义了 egjs-jsdoc-template 的相关参数，其中包括主题、代码行数等。
完成配置文件后，我们需要在项目中添加以下脚本：
"scripts": {
"doc": "jsdoc ./src --configure ./.jsdocrc.json"
}执行以下命令：
npm run doc
即可输出美观的文档。
示例
让我们来看一个简单的示例，下面是一个util.js文件：
-- -------------------- ---- ------- --- - --------- - ------ -------- --- - ------ - ------- -------- -------- -- -------- ---------------- - ------ ------------ - -------------- - - ----------- --
在 ./src/ 生效构建后执行以下node脚本
const util = require('./util');
console.dir(util.parseNumber('5'));我们可以执行以下命令来生成文档：
npm run doc
然后就可以在./docs里看到生成好的文档，如下一张简单的图表：
自定义模板
如果你希望能够自己设计文档，egjs-jsdoc-template 也提供了自定义模板的功能。通过继承默认模板，我们可以使用 handlebars 模板语言自由设计我们想要的文档格式。具体的自定义方法可以参考 egjs-jsdoc-template 的官方文档。
总结
npm 包 egjs-jsdoc-template 是一个用于生成漂亮文档的工具，可以帮助我们快速便捷地理解和管理代码。本文介绍了安装、使用和自定义模板的方法，希望能帮助读者更好地利用 npm 包管理工具。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/5ef84cd9403f2923b035b96b