root 3bf41bf355 update | пре 1 година | |
---|---|---|
.. | ||
lib | пре 1 година | |
node_modules | пре 1 година | |
plugins | пре 1 година | |
templates | пре 1 година | |
Apache_License_2.0.txt | пре 1 година | |
LICENSE.md | пре 1 година | |
README.md | пре 1 година | |
cli.js | пре 1 година | |
conf.json.EXAMPLE | пре 1 година | |
jsdoc.js | пре 1 година | |
package.json | пре 1 година |
An API documentation generator for JavaScript.
Want to contribute to JSDoc? Please read CONTRIBUTING.md
.
JSDoc supports stable versions of Node.js 12.0.0 and later. You can install
JSDoc globally or in your project's node_modules
folder.
To install the latest version on npm globally (might require sudo
;
learn how to fix this):
npm install -g jsdoc
To install the latest version on npm locally and save it in your package's
package.json
file:
npm install --save-dev jsdoc
To install the latest development version locally, without updating your
project's package.json
file:
npm install git+https://github.com/jsdoc/jsdoc.git
If you installed JSDoc locally, the JSDoc command-line tool is available in
./node_modules/.bin
. To generate documentation for the file
yourJavaScriptFile.js
:
./node_modules/.bin/jsdoc yourJavaScriptFile.js
If you installed JSDoc globally, run the jsdoc
command:
jsdoc yourJavaScriptFile.js
By default, the generated documentation is saved in a directory named out
. You
can use the --destination
(-d
) option to specify another directory.
Run jsdoc --help
for a complete list of command-line options.
The JSDoc community has created templates and other tools to help you generate and customize your documentation. Here are a few of them:
jsdoc
to
Stack Overflow.JSDoc is copyright (c) 2011-present Michael Mathews micmath@gmail.com and the contributors to JSDoc.
JSDoc is free software, licensed under the Apache License, Version 2.0. See the
file LICENSE.md
in this distribution for more details.