现代JavaScript的文档系统。
- 支持现代JavaScript:ES5,ES2017,JSX和Flow类型注释。
- 影响参数,类型,成员资格等。 写更少的文档:让电脑为你写。
- 与GitHub集成,直接从文档链接到它引用的代码。
- 可自定义的输出:HTML,JSON,Markdown等
现代JavaScript的文档系统。(The documentation system for modern JavaScript. )
现代JavaScript的文档系统。
名稱與所有者 | documentationjs/documentation |
---|---|
主編程語言 | JavaScript |
編程語言 | JavaScript (語言數: 4) |
平台 | |
許可證 | Other |
發布數 | 116 |
最新版本名稱 | v14.0.3 (發布於 2024-01-30 13:48:23) |
第一版名稱 | v1.0.1 (發布於 2015-04-08 19:25:40) |
創建於 | 2015-03-10 03:34:09 |
推送於 | 2024-04-22 22:12:34 |
最后一次提交 | 2024-02-01 09:45:43 |
星數 | 5.8k |
關注者數 | 59 |
派生數 | 482 |
提交數 | 1.4k |
已啟用問題? | |
問題數 | 797 |
打開的問題數 | 195 |
拉請求數 | 563 |
打開的拉請求數 | 11 |
關閉的拉請求數 | 265 |
已啟用Wiki? | |
已存檔? | |
是復刻? | |
已鎖定? | |
是鏡像? | |
是私有? |
:date: Current maintenance status
Globally install documentation
using the npm package manager:
$ npm install -g documentation
This installs a command called documentation
in your path, that you can
point at JSDoc-annotated source code to generate
human-readable documentation. First, run documentation
with the --help
option for help:
Usage:
# generate markdown docs for index.js and files it references
documentation build index.js -f md
# generate html docs for all files in src
documentation build src/** -f html -o docs
# document index.js, ignoring any files it requires or imports
documentation build index.js -f md --shallow
# build and serve HTML docs for app.js
documentation serve app.js
# build, serve, and live-update HTML docs for app.js
documentation serve --watch app.js
# validate JSDoc syntax in util.js
documentation lint util.js
# update the API section of README.md with docs from index.js
documentation readme index.js --section=API
# build docs for all values exported by index.js
documentation build --document-exported index.js
Commands:
serve [input..] generate, update, and display HTML documentation
build [input..] build documentation
lint [input..] check for common style and uniformity mistakes
readme [input..] inject documentation into your README.md
Options:
--version Show version number [boolean]
--help Show help [boolean]
We have plenty of
issues that we'd
love help with.
JSDoc
support, including typedefs.documentation is an OPEN Open Source Project. This means that:
Individuals making significant and valuable contributions are given
commit-access to the project to contribute as they see fit. This
project is more like an open wiki than a standard guarded open source project.