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.
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
srcdirectory to the
pluginsdirectory in JSDoc's installation directory.
Edit JSDoc's conf file and add path to the plugin in the
pluginsarray. For example, if you want to use the staticFiles plugin and have copied
plugins/staticFilesdirectory, then your plugins array would contain:
Put in plugin specific configuration in JSDoc's conf file. Each plugin's configuration options are provided in a
README.mdwithin the plugin specific folder.
- You are all set!
List of plugins
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.