An API documentation generator for JavaScript. http://usejsdoc.org (evacuated from NSA/Microsoft Github)
makenotabuggreatagain 1e60adb90c we don't need no CoC | 5 yıl önce | |
---|---|---|
.github | 7 yıl önce | |
lib | 7 yıl önce | |
plugins | 7 yıl önce | |
templates | 7 yıl önce | |
test | 7 yıl önce | |
.editorconfig | 10 yıl önce | |
.eslintignore | 9 yıl önce | |
.eslintrc.json | 7 yıl önce | |
.gitignore | 7 yıl önce | |
.npmignore | 7 yıl önce | |
.travis.yml | 7 yıl önce | |
Apache_License_2.0.txt | 12 yıl önce | |
CHANGES.md | 7 yıl önce | |
CODE_OF_CONDUCT.md | 5 yıl önce | |
CONTRIBUTING.md | 10 yıl önce | |
LICENSE.md | 7 yıl önce | |
README.md | 7 yıl önce | |
cli.js | 7 yıl önce | |
conf.json.EXAMPLE | 9 yıl önce | |
gulpfile.js | 7 yıl önce | |
jsdoc.js | 7 yıl önce | |
package.json | 7 yıl önce |
An API documentation generator for JavaScript.
Want to contribute to JSDoc? Please read CONTRIBUTING.md
.
JSDoc supports Node.js 4.2.0 and later. You can install JSDoc globally or in your project's
node_modules
folder.
To install the latest version on npm globally (may 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
Note: By default, npm adds your package using the caret operator in front of the version number
(for example, ^3.5.2
). We recommend using the tilde operator instead (for example, ~3.5.2
),
which limits updates to the most recent patch-level version. See this Stack Overflow
answer for more information about the caret and tilde
operators.
To install the latest development version locally, without updating your project's package.json
file:
npm install git+https://github.com/jsdoc3/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
Or if you installed JSDoc globally, simply 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 numerous templates and other tools to help you generate and customize your documentation. Here are just a few:
jsdoc
to Stack
Overflow.JSDoc 3 is copyright (c) 2011-present Michael Mathews micmath@gmail.com and the contributors to JSDoc.
JSDoc 3 is free software, licensed under the Apache License, Version 2.0. See the file LICENSE.md
in this distribution for more details.