npm 包 minami_customized 使用教程

阅读时长 4 分钟读完

前言

npm 是一个常用的 JavaScript 包管理器,其中包含了各种工具、框架、模块等,提供了大量的前端资源。mimani_customized 是一个 npm 包,是针对开源项目 jsdoc3 的一个自定义主题,为 jsdoc3 文档生成工具提供了一个定制化的主题样式,可以更好地呈现 jsdoc3 生成的文档内容。

安装

首先,需要在本地或者项目中安装 jsdoc 和 minami_customized,安装命令如下:

使用

安装完成之后,就可以使用 minami_customized 来生成自定义的 jsdoc3 文档了,具体步骤如下:

  1. 在项目中添加 jsdoc 配置文件 jsdoc.conf.json,文件内容如下:
-- -------------------- ---- -------
-
  ------- -
    ------------------- -----
    --------------- ---------
  --
  --------- -
    ---------- -
      ------
      -----------
    --
    ---------- -
      --------------
    --
    ----------------- -----------------
    ----------------- ---------------
  --
  ------- -
    ----------- --------------------
    -------------- --------
    ----------- -------
    ---------- -----
    ---------- -----
    --------- --------------
    --------- ------
    ---------- ----------------
  -
-
  1. 执行以下命令,生成文档:

待生成完成后,打开 docs/index.html 即可浏览生成的自定义文档了。

示例代码

-- -------------------- ---- -------
---
 - ----- ------------ - ------
 - ----------------
 --
----- ----- -
  ---
   - ------ - ------
   - ------ -------- - - --- - ------
   - ------ -------- - - --- - ------
   --
  -------------- -- -

    ---
     - --- - ------
     - ---------
     --
    ------ - --

    ---
     - --- - ------
     - ---------
     --
    ------ - --
  -

  ---
   - --- --- -------- ---- ---- ----- -- ------- ------
   - ------ ------- ----- - --- ----- ------
   - ------- -------- --- ---------
   --
  ----------------- -
    ----- -- - ------ - --------
    ----- -- - ------ - --------

    ------ --------------- - -------
  -
-

结语

minami_customized npm 包提供了一个定制化的 jsdoc3 主题样式,可以更好地展现文档内容。本篇文章介绍了该包的安装和使用方法,并提供了示例代码,希望能对前端开发者有所帮助。

来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/60066f481d8e776d08041150

纠错
反馈