Generates an apiDoc plugin for defining a page.
As an extension of apiDoc, first install at least apiDoc-core.
This plugin, as with all apiDoc plugins named as apidoc-plugin-*
, can be installed locally or globally alongside the apidoc-core
.
Run either npm install apidoc-plugin-page
or npm install -g apidoc-plugin-author
.
Run npm install git+https://git@github.com/gleuch/apidoc-plugin-page.git
As the author of API endpoints looking for a way to start documentation and actually maintain it, apiDoc is a great way to go. Those who are new to the syntax of apiDoc should thoroughly read the associated documentation. Once familiar with the general syntax, add something similar to the following, to include the author
field in the generated documentation.
The ability to quickly generate an API doc is useful, it generating documentation for a large project can be burdensome for the developer to understand where to find something. By including an @apiPage [name]
with some template changes, anyone can make a multi-page API documentation.
/**
* @apiPage Users
**/
The generated api_data.json
should now include a block like
{
"page": "Users"
}
...
- Parse
@apiPage
- Publish node module
- Finalize APIDoc template
- Publish APIDoc template