概览

One-stop solution for vue component documentation

WARNING

这个文档是对于 2.x 的,如果你使用 1.x,你应该更新到 2.x,因为 2.x 完全兼容 1.x

Vuese 为你的 vue 组件自动生成文档,它提供了多种生成组件文档的解决方案,用来满足你不同的需求。

@vuese/cli

@vuese/cli 是一个命令行工具,使用它非常简单,如果你希望快速为你的 vue 组件建立文档网站或只想为你的 vue 组件生成 markdown 文档,那么这个工具或许是个不错的选择。详情请移步:@vuese/cli

@vuese/parser

@vuese/parser 模块是 vue 组件的解析器,@vuese/cli 内部通过 @vuese/parser 模块解析 vue 组件,并提取想要得到的信息。你可以通过 @vuese/parser 模块提供的接口做任何更高级的事情,API 文档请移步:@vuese/parser

@vuese/markdown-render

@vuese/markdown-render 模块接收 @vuese/parser 模块返回的对 vue 组件的解析结果,并生成 markdown 字符串。@vuese/cli 的文档生成功能也应用到了该模块,换句话说,你可以单独使用 @vuese/parser@vuese/markdown-render 来编写你自己的 CLI 工具,从而实现一些有趣的东西。

@vuese/loader

@vuese/cli 是一个快速创建 docute 文档站点的工具,它不具有更灵活的文档解决方案。因为你或许已经为你的组件建立了文档站点,你只是希望 Vuese 能为你完成能够自动完成的东西,比如提取组件的接口信息自动生成 markdown 表格。此时你可以使用 @vuese/loader 配合 @vuese/webpack-plugin 帮助你以“自动”的方式维护你的组件文档,节省你的时间。

@vuese/webpack-plugin

[TODO]