前言
npm 是一个常用的 JavaScript 包管理器,其中包含了各种工具、框架、模块等,提供了大量的前端资源。mimani_customized 是一个 npm 包,是针对开源项目 jsdoc3 的一个自定义主题,为 jsdoc3 文档生成工具提供了一个定制化的主题样式,可以更好地呈现 jsdoc3 生成的文档内容。
安装
首先,需要在本地或者项目中安装 jsdoc 和 minami_customized,安装命令如下:
// 安装 jsdoc $ npm install -g jsdoc // 安装 minami_customized $ npm install minami_customized
使用
安装完成之后,就可以使用 minami_customized 来生成自定义的 jsdoc3 文档了,具体步骤如下:
- 在项目中添加 jsdoc 配置文件 jsdoc.conf.json,文件内容如下:
-- -------------------- ---- ------- - ------- - ------------------- ----- --------------- --------- -- --------- - ---------- - ------ ----------- -- ---------- - -------------- -- ----------------- ----------------- ----------------- --------------- -- ------- - ----------- -------------------- -------------- -------- ----------- ------- ---------- ----- ---------- ----- --------- -------------- --------- ------ ---------- ---------------- - -
- 执行以下命令,生成文档:
$ jsdoc -c jsdoc.conf.json
待生成完成后,打开 docs/index.html 即可浏览生成的自定义文档了。
示例代码
-- -------------------- ---- ------- --- - ----- ------------ - ------ - ---------------- -- ----- ----- - --- - ------ - ------ - ------ -------- - - --- - ------ - ------ -------- - - --- - ------ -- -------------- -- - --- - --- - ------ - --------- -- ------ - -- --- - --- - ------ - --------- -- ------ - -- - --- - --- --- -------- ---- ---- ----- -- ------- ------ - ------ ------- ----- - --- ----- ------ - ------- -------- --- --------- -- ----------------- - ----- -- - ------ - -------- ----- -- - ------ - -------- ------ --------------- - ------- - -
结语
minami_customized npm 包提供了一个定制化的 jsdoc3 主题样式,可以更好地展现文档内容。本篇文章介绍了该包的安装和使用方法,并提供了示例代码,希望能对前端开发者有所帮助。
来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/60066f481d8e776d08041150