安装依赖
安装vue-template-compiler
npm install vue-template-compiler npm install vue-template-compiler
安装minami
npm install minami
安装js-doc
npm install js-doc
根目录下创建 .jsdoc.conf.json
内容:
{ "tags": { "allowUnknownTags": true, // 指定所用词典 "dictionaries": [ "jsdoc" ] }, // 查找文件的深度 需要用 -r 参数 "recurseDepth": 10, "source": { "include": [ // 需要编译的文件路径 使用时请替换 "./src/index/packages" ], "includePattern": ".+\\.(vue)$", "excludePattern": "(^|\\/|\\\\)_" }, // 使用插件 "plugins": [ // 插件路径 "./jsdoc-vue" ], "templates": { "cleverLinks": false, "monospaceLinks": true, "useLongnameInNav": false, "showInheritedInNav": true }, "opts": { // 文档输出路径 "destination": "./src/index/doc", "encoding": "utf8", "private": true, "recurse": true, // 使用模板 minami "template": "./node_modules/minami" } }
根目录创建 jsdoc-vue.js
内容:
var compiler = require("vue-template-compiler"); exports.handlers = { // 利用 vue-template-compiler 编译 vue 模板 beforeParse: function(e) { if (/\.vue$/.test(e.filename)) { var output = compiler.parseComponent(e.source); e.source = output.script ? output.script.content : ""; } } };
package.json
内容:
"doc": "jsdoc -r -c .jsdoc.conf.json"
使用npm run doc 运行