npm 包 esdoc-exclude-source-plugin 使用教程

前言

ESDoc 算是目前比较主流的 JavaScript 文档生成工具。它本身提供了许多可以满足大部分前端开发者的功能,但有时候有些需求需要手动进行插件扩展,比如防止生成文档时出现源代码等。

本文就是想介绍一下如何使用一个 npm 包叫做 esdoc-exclude-source-plugin,该插件可以排除源代码不生成到文档中。

安装

首先需要全局安装 ESDoc:

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

然后安装插件:

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

使用

在 ESDoc 的配置文件中加入该插件即可:

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

然后运行 ESDoc 即可生成文档:

-----

生成的文档将不会包含源代码。

示例代码

假如有以下测试代码:

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

生成文档后,乘积的函数将只有下面这一段注释信息:

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

结语

ESDoc 的插件机制还是很强大的。esdoc-exclude-source-plugin 的使用只是其中之一。在实际的项目中,还可以根据需求开发适合自己的插件。

来源:JavaScript中文网 ,转载请联系管理员! 本文地址:https://www.javascriptcn.com/post/60055eae81e8991b448dc34f


猜你喜欢

  • npm 包 mozaik-ext-valuetable 的使用教程

    什么是 mozaik-ext-valuetable? mozaik-ext-valuetable 是一个基于 Mozaik 工具提供的数据可视化 npm 包,主要用于展示表格数据。

    2 年前
  • npm 包 spreadem 使用教程

    在前端开发中,经常需要操作对象和数组。借助 ES6 中的扩展运算符(spread operator)可以方便地操作对象和数组,将它们展开成不同的元素。然而,在一些特定场景下,扩展运算符并不能满足我们的...

    2 年前
  • npm 包 vuetalisk-plugin-mustache-simple 使用教程

    前言 在前端开发中,我们经常需要进行数据渲染和表达式赋值操作。用于这些操作的模板引擎有很多,而 Mustache 是其中的一种。提供了一个独立于编程语言的模板语法,易于学习和使用。

    2 年前
  • npm 包 grpc-sdk-client 使用教程

    前言 gRPC 是一种高性能的远程过程调用框架,可以跨语言使用,支持多种平台。很多公司也在使用 gRPC 进行服务化架构的实现,让前端同学也学习一下是很有必要的。这里介绍一下如何使用 npm 包 gr...

    2 年前
  • npm 包 qml-polyfill 使用教程

    在前端开发中,有些项目需要使用 QML 技术,但很多浏览器并不支持。此时我们可以使用 qml-polyfill 这个 npm 包来实现兼容性。 什么是 qml-polyfill qml-polyfil...

    2 年前
  • npm 包 vue-imageview 的使用教程

    前言 随着前端技术的发展,我们越来越依赖于各种 npm 包来完成我们的任务。npm 包的使用可以大大提高我们的工作效率,同时也拓展了我们的技术栈。本篇文章将介绍一个前端类的 npm 包,名为 vue-...

    2 年前
  • npm 包 @fictiv/jwks-rsa 使用教程

    在前端开发中,我们经常需要与后端进行数据通信,这时我们需要进行数据加密和解密,其中 JSON Web Token (JWT) 是一种安全的数据传输方式。而 JSON Web Key (JWK) 是一种...

    2 年前
  • npm 包 onmilliseconds 使用教程

    在前端开发过程中,经常需要处理时间相关的需求。例如计时器的实现,时间戳的转换和格式化等等。在这些场景下,我们通常会使用各种前端库或者工具,其中一种被广泛使用的 npm 包就是 onmillisecon...

    2 年前
  • npm 包 tslint-config-nimedev-ng 使用教程

    在前端开发中,代码规范和风格的统一对于团队协作和代码维护非常重要。为了实现这一目标,使用 linter 工具可以帮助我们自动化地检测和修复代码风格问题。tslint 是一种流行的 linter 工具,...

    2 年前
  • npm 包 @foundry-ai/foundry-service-loader 使用教程

    在现代的 Web 开发中,前端技术占据了越来越重要的地位。而在前端开发中,使用各种 npm 包已经成为了日常工作的必备。今天我要介绍的是一个非常优秀的 npm 包,它就是 @foundry-ai/fo...

    2 年前
  • npm 包 @foundry-ai/foundry-vo 使用教程

    简介 npm 包 @foundry-ai/foundry-vo 是一个对语音助手进行自定义配置和优化的工具包。它可以帮助前端开发者更好地管理和优化语音助手的表现,提升用户体验和满意度。

    2 年前
  • npm 包 foundry-firehose 使用教程

    简介 foundry-firehose 是一个开源的 npm 包,旨在提供从 Foundry VTT 游戏框架捕获事件并将它们转发到其他应用程序的能力。该包适用于需要捕获游戏事件并在应用程序中处理的开...

    2 年前
  • NPM 包 foundrybot 使用教程

    在前端项目开发中,使用 NPM 包可以极大提高开发效率。在众多 NPM 包中,foundrybot 凭借其简单易用的特点而备受青睐。本文将为大家详细介绍如何使用 foundrybot。

    2 年前
  • npm 包 load-image-queue 使用教程

    在前端开发中,处理图片是一个常见的需求。通常情况下,我们可以使用 HTML 中的 <img> 标签来加载图片。但是,如果需要在 web 应用中处理大量的图片,使用 <img> ...

    2 年前
  • npm 包 new-react-app 使用教程

    在前端开发中,创建一个 React 应用程序是一个常见的任务,为了使这个过程更加简单和高效,Facebook 团队开发并推出了一个命名为 create-react-app 的著名的工具。

    2 年前
  • npm 包 react-native-uncontrolled-date-picker-ios 使用教程

    在 React Native 开发过程中,有很多需要处理日期和时间的场景,比如日历、倒计时、倒计时器等等。而这些场景往往需要使用日期选择器组件,如果自己编写日期选择器,不仅要花费大量时间和精力,而且可...

    2 年前
  • NPM 包 React Perfect UI 使用教程

    React Perfect UI 是一个专门为 React 前端开发者设计的 UI 库,提供了一套优美、易用和高效的组件系统,可以快速搭建美观的用户界面。本文将详细介绍如何使用 React Perfe...

    2 年前
  • npm 包 load-queue 使用教程

    在前端开发中,我们经常需要加载大量资源(如图片、音频、视频等)。但在整个网页加载过程中,可能会因为同时加载的过多而出现卡顿或者页面加载较慢的情况。为了解决这个问题,我们可以使用一个叫做 load-qu...

    2 年前
  • npm 包 nemex-angular2-tooltip 使用教程

    在 Angular2 中实现 tooltip 功能需要写很多代码,为了简化这个过程,开发者们写了很多 npm 包来解决这个问题。其中,nemex-angular2-tooltip 是一款非常优秀的 t...

    2 年前
  • npm 包 readable-stream-node-to-web 使用教程

    前言 在前端开发过程中,有时需要将 Node.js 环境下的可读流(Readable Stream)转换为在浏览器环境下可用的可读流,以实现更多的功能。而 npm 包 readable-stream-...

    2 年前

相关推荐

    暂无文章