Simply preview your jsdoc generation on your browser.
Each time a *.js or *.md file is saved, jsdoc is launched on its parent directory and the preview page is automatically reloaded (or opened if not exist).
You can open a new page in your browser with the command Preview JSDoc : Open browser
.
No need to have jsdoc installed on your machine.
This extension contributes the following settings:
previewjsdoc.autoOpenBrowser
: enable/disable the auto opening of the browser at the first save.previewjsdoc.confFile
: the JSON configuration file passed tojsdoc -c confFile.json
. More details on http://usejsdoc.org/about-configuring-jsdoc.htmlpreviewjsdoc.tutorials
: set a list paths which may contain jsdoc tutorials. A glob pattern or relative path are possible to use. This list will be merged into a single tutorial folder and will be passed tojsdoc -t
. For example
"previewjsdoc.tutorials" : ["**/tutorials/*"] // copy all folders containing tutorials as child folder.
previewjsdoc.output
: set the output where the extension generates the conf.json, the root directory to store jsdoc generated files and the merged tutorials folder
If you want to use a different template than the default one. You can set in your configuration file the location of this template.
For example, if you want to use the template fooDoc.
- Get the absolute path where you installed this template.
- Update the configuration file like below
{
"opts": {
...
"template": "<root path>/node_modules/foodoc/template"
}
}
- Open the preview jsdoc browser or save a file to see the new template
Look at the Changelog
This extension has been inspired from Instant Markdown extension.