Socket
Socket
Sign inDemoInstall

bouquet

Package Overview
Dependencies
0
Maintainers
2
Versions
5
Alerts
File Explorer

Advanced tools

Install Socket

Detect and block malicious and high-risk dependencies

Install

    bouquet

Collection of useful plugins for JSDoc


Version published
Maintainers
2
Install size
17.1 kB
Created

Readme

Source

Bouquet logo GitHub version NPM version Build Status

Bouquet

A collection of plugins for JSDoc, that can be readily integrated with JSDoc installations to extend the functionalities of JSDoc without editing the core of JSDoc.

Why Bouquet?

Often we need to extend JSDoc to support different use cases that are not satisfied by JSDoc. For example, someone might need to include additional files in their documentation, or parse additional directives.

JSDoc exposes a plugins architecture that can be used to address those use cases, without hacking on the core JSDoc files. Bouquet is an effort to provide a unified collection of such useful plugins for use with JSDoc.

How to use Bouquet?

Each plugin in Bouquet is contained in a separate directory within the src directory. Generic instruction for using a Bouquet plugin is:

  • Clone the Bouquet repository.

  • Copy plugin directory from src directory to the plugins directory in JSDoc's installation directory.

  • Edit JSDoc's conf file and add path to the plugin in the plugins array. For example, if you want to use the staticFiles plugin and have copied src/staticFiles to JSDoc's plugins/staticFiles directory, then your plugins array would contain:

      "plugins": ["plugins/staticFiles/staticFiles"]
    
  • Put in plugin specific configuration in JSDoc's conf file. Each plugin's configuration options are provided in a README.md within the plugin specific folder.

  • You are all set!

List of plugins

staticFiles

Copies static files in source to generated documentation based on user-specified include paths, inclusion and exclusion patters, with support for recursive copying. [Know more]

Road ahead

  • Plugin to re-order, rename and include custom menu items in JSDoc.
  • Plugin for global search.
  • Plugin to analyze documentation coverage.
  • Plugin to embed JSFiddle by supplying a fiddle URL.
  • Plugin to embed FusionCharts in tutorials and reference chart types from API.

Keywords

FAQs

Last updated on 14 Jan 2014

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc