利用jsdoc为vue项目生成漂亮的文档

jsdoc是前端自动生成文档所经常使用的工具。咱们只要按照jsdoc的语法来书写注释就能顺利的生成一片很漂亮的文档。

只是jsdoc针对的是js文件，对于.vue文件彷佛就有些无能为力了。不过既然vue这么人气，相信必定也会有相应的工具。在找了一圈以后，果真找到了一位前辈写的jsdoc-vue。

在研究了一下以后，发现这个工具主要解决了jsdoc不认.vue文件的问题。虽然可让.vue文件自动生成文档，但生成出的文档样式却并很差看。因而就fork过来改造了一下。

废话很少说，先上一张生成的文档截图。 github地址：jsdoc-vue 改造版

改造的部分主要有如下几点：

1. 使用了jsdoc字典，所以可使用jsdoc自带的标签来进行编写。这样也便于生成须要的模板。
2. 生成文档采用了minami模板
3. 升级了 vue-template-complier 和 jsdoc 模块

安装使用方法

git clone git@github.com:Konata9/jsdoc-vue.git

npm install 
复制代码

这个改造后的版本我本身用着还算比较满意，比较重要的如props和components组件均可以利用jsdoc自带的语法比较清楚的表示出来。

若是各位喜欢的话，但愿能够点一个star。固然，若是有改进的地方也但愿各位能够指点一下。