Presidium Jsdoc
A template-based tool for importing Jsdoc into you Presidium documentation.
This tool uses the Jsdoc node module to parse and generate your documentation with a customized template based off of Jsdoc's default template. It produces html files, structures them appropriately and inserts them into your Presidium project.
Install
In your project root:
$ npm install --save presidium-jsdoc
Usage:
Standalone
usage: presidium-jsdoc
Option | Description |
---|---|
-d,--directory path
|
The path to the output directory in ./content e.g. ./content/_reference/mydocs . \n |
-h,--help | Shows this help. |
-p,--path path
|
The path from which static files are served e.g. ./media/import/mydocs . Defaults to ./media/jsdoc/<title> . |
-s,--sourcepath path
|
The path to the project's source. |
-t,--title string
|
The title of the output folder. Defaults to the directory name supplied with -d if no package information can be found. |
In Presidum
$ npm run presidium-jsdoc -s <path> -d <path> -t <string> -p <path>
Known Issues:
- Does not yet support user supplied Jsdoc config.
- Links to pages are not yet resolved by this tool.
- Does not yet allow author tags to be added to the ingested documentation.