Tickly / vuepress-plugin-code-example

2 stars 3 forks source link

vuepress-plugin-code-example

你总不想你的示例文档要这么写吧?

## 基本用法

<table-basic-usage />
<<< @/docs/.vuepress/components/table/basic-usage.vue

🤔一个地址为啥要写两遍
🙄我记不住这么长路径啊

那你就可以用这个插件了。

Install

yarn add vuepress-plugin-code-example

Vuepress Config

.vuepress/config.js

module.exports = {
  plugins: ["code-example"],
};

Usage

首先参考官网的使用组件章节,编写你的组件示例代码。

比如你的示例代码文件路径为 .vuepress/components/demo.vue

然后在你的.md文件里,按照如下格式编写。

::: code-example demo.vue
:::

code-example会被插件解析到,后面填写组件的相对路径即可。

Feature

Preview

默认效果

在线效果

可参考我的一个组件库文档erpack

FAQ

注意,目前插件代码里面包含了ant-design-vue的代码,所以要在你的项目中先安装该依赖。
我会尽快移除该限制。

Todo