Tip: This project is no longer actively maintained, maybe you can try Vue DocGen Cli or Vue DocGen Api instead.
A jsdoc plugin use @vuedoc/md.
- [email protected]: That support
async/awaitfeatures. - @vuedoc/md.
npm i jsdoc-vuedoc -Dadd
jsdoc-vuedocnode tojsdoc.json.
tag: default@vuedoc.log: defaulttrue.- the other vuedco/md options.
This plugin just extract the component's info into
markdownformat, and instert it into the@vuedoc's position.
Not affect other jsdoc features of the code.
- add
@vuedoctag to comment. - add
@exports componentNametag to comment.
just add @vuedoc tag, @exports tag, to the to document in you vue SFC.
/**
* sidebar component description
* @vuedoc
* @exports component/SideBar
*/
export default {}- 安装jsdoc:
npm i jsdoc -D - 安装模板：
npm i sherry-docstrap -D, 原来的docstrap有点小bug还未修复，所以自己暂时发布一个。 - 在项目目录下建了配置文件：下面有示例，适当修改。
- 在pacakge.json 里添加一个script:
"jsdoc": "rm -rf public/jsdoc && node_modules/.bin/jsdoc -c jsdoc.json",public/jsdoc为发布位置，适当修改 - 生成文档:
npm run jsdoc
{
"plugins": [
"node_modules/jsdoc-vuedoc",
"plugins/markdown",
"plugins/summarize"
],
"jsdoc-vuedoc": {
"tag": "vuedoc"
},
"markdown": {
"tags": ["author", "classdesc", "description", "param", "property", "returns", "see", "throws"]
},
"recurseDepth": 10,
"source": {
"include": ["fe/src"],
"includePattern": ".+\\.(js|vue)$",
"excludePattern": "(^|\\/|\\\\)_"
},
"sourceType": "module",
"tags": {
"allowUnknownTags": true,
"dictionaries": ["jsdoc", "closure"]
},
"templates": {
"logoFile": "",
"cleverLinks": false,
"monospaceLinks": false,
"dateFormat": "ddd MMM Do YYYY",
"outputSourceFiles": true,
"outputSourcePath": true,
"systemName": "DocStrap",
"footer": "",
"copyright": "DocStrap Copyright © 2012-2015 The contributors to the JSDoc3 and DocStrap projects.",
"navType": "vertical",
"theme": "cosmo",
"linenums": true,
"collapseSymbols": false,
"inverseNav": true,
"protocol": "html://",
"methodHeadingReturns": false
},
"markdown": {
"parser": "gfm",
"hardwrap": true
},
"opts": {
"template": "node_modules/sherry-docstrap/template",
"encoding": "utf8",
"destination": "./public/jsdoc/",
"recurse": true,
"readme": "README.md",
"tutorials": "./docs/"
}
}
.