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.
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.
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 theplugins
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 copiedsrc/staticFiles
to JSDoc'splugins/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!
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]
- 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.