2.14.25 • Published 5 years ago
@hjtvuese/cli v2.14.25
vue组件文档自动生成
基于 vuese
使用方式同vuese,命令替换为hjtvuese,配置文件将会读取 .hjtvueserc 或 hjtvuese.config.js
安装
npm install @hjtvuese/cli -D 或 yarn add @hjtvuese/cli -D
使用
生成文档
npx hjtvuese gen
或者写入package.json中
"scripts": {
"docs": "hjtvuese gen"
}
npm run docs
使用配置文件
在根目录创建 .hjtvueserc 或 hjtvuese.config.js
module.exports = {
title: 'xxx组件文档', // 生成组件文档index的title
include: ['**/*.vue'], // 包含的文件
exclude: [], // 排除的文件,node_modules已被默认排除
outDir: './docs', // 文档的输出目录
}
预览组件文档
npx hjtvuese serve --open
响应式预览单个组件文档
npx hjtvuese preview ./src/components/CmpA.vue
为你的组件编写文档
改造添加的功能
1.支持自定义编写markdown
可使用 *desc 开头的注释来标记自定义markdown描述,显示在抬头位置。在vuese基础上可以写一些自定义的内容,比如组件的使用例子。
需要将注释的位置放在 import 与 export default {} 之间
import xxx from 'xxx';
/**desc
## 组件描述
...
*/
// @group xxx
export default {}
解析后:
2.对生成的md文件添加相对路径标识
解决2个不同位置同名组件覆盖的问题。
3.增量更新
组件文件未修改,不会再重新生成md文件
2.14.25
5 years ago
2.14.24
5 years ago
2.14.23
5 years ago
2.14.22
5 years ago
2.14.21
5 years ago
2.14.20
5 years ago
2.14.19
5 years ago
2.14.18
5 years ago
2.14.16
5 years ago
2.14.17
5 years ago
2.14.14
5 years ago
2.14.15
5 years ago
2.14.13
5 years ago
2.14.12
5 years ago
2.14.10
5 years ago
2.14.11
5 years ago
2.14.9
5 years ago
2.14.8
5 years ago
2.14.7
5 years ago
2.14.6
5 years ago
2.14.5
5 years ago
2.14.4
5 years ago
2.14.3
5 years ago