From 4069ea33028299ddce3a894725d3bb8aaafc1c54 Mon Sep 17 00:00:00 2001 From: yangdong <764104430@qq.com> Date: Wed, 15 Feb 2023 14:32:30 +0800 Subject: [PATCH] first commit --- .github/workflows/docs.yml | 0 README.md | 1 + docs/.vuepress/client.js | 0 docs/.vuepress/config.js | 38 ++++++++++++++++++++++++++++++++ docs/g-e-choose-icon/index.md | 30 +++++++++++++++++++++++++ docs/getting-started/index.md | 41 +++++++++++++++++++++++++++++++++++ docs/intro/index.md | 6 +++++ 7 files changed, 116 insertions(+) create mode 100644 .github/workflows/docs.yml create mode 100644 README.md create mode 100644 docs/.vuepress/client.js create mode 100644 docs/.vuepress/config.js create mode 100644 docs/g-e-choose-icon/index.md create mode 100644 docs/getting-started/index.md create mode 100644 docs/intro/index.md diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml new file mode 100644 index 0000000..e69de29 diff --git a/README.md b/README.md new file mode 100644 index 0000000..c2ae38f --- /dev/null +++ b/README.md @@ -0,0 +1 @@ +# g-element-plus-components-doc diff --git a/docs/.vuepress/client.js b/docs/.vuepress/client.js new file mode 100644 index 0000000..e69de29 diff --git a/docs/.vuepress/config.js b/docs/.vuepress/config.js new file mode 100644 index 0000000..d7916ce --- /dev/null +++ b/docs/.vuepress/config.js @@ -0,0 +1,38 @@ +// 配置 +export default { + // 网站标题 + title: '基于element-plus二次封装组件', + // 部署的基础路径 + base: '/docs/', + // 配置网站html的head标签 + head: [], + // 主题配置 + themeConfig: { + nav: [ + { + text: '首页', + link: '/' + } + ], + sidebar: [ + { + text: '介绍', + link: '/intro/', + items: [ + { text: '介绍', link: '/intro/' }, + { text: '快速开始', link: '/getting-started/' }, + // { text: '图标选择器', link: '/g-e-choose-icon/' }, + // { text: '表单', link: '/g-e-form/' }, + // { text: '弹框表单', link: '/g-e-modal-form/' }, + // { text: '表格', link: '/g-e-table/' }, + ] + }, + ], + docFooter: { prev: '上一篇', next: '下一篇' }, + lastUpdatedText: "最近更新时间" + }, + markdown: { + lineNumbers: true + }, + lastUpdated: true, +} diff --git a/docs/g-e-choose-icon/index.md b/docs/g-e-choose-icon/index.md new file mode 100644 index 0000000..0b23628 --- /dev/null +++ b/docs/g-e-choose-icon/index.md @@ -0,0 +1,30 @@ +## 图标选择器 +用户点击按钮,弹出框显示所有图标,点击图标可以复制图标组件标签。 + +### 基本用法 +
+ + 选择图标 + +
+ +### 代码示例 + + +- 图标插件依赖`@element-plus/icons-vue` + ```shell + pnpm install @element-plus/icons-vue + ``` +- 示例 + ```js + 选择图标 + + ``` diff --git a/docs/getting-started/index.md b/docs/getting-started/index.md new file mode 100644 index 0000000..52e65bc --- /dev/null +++ b/docs/getting-started/index.md @@ -0,0 +1,41 @@ +## 快速开始 + +### 版本 +`g-element-plus-components`目前还处于快速开发迭代中。 + +### 安装 +```shell +# 选择一个你喜欢的包管理器 + +# NPM +$ npm install g-element-plus-components --save + +# Yarn +$ yarn add g-element-plus-components + +# pnpm +$ pnpm install g-element-plus-components +``` + +### 用法 +- 全局引入 + - 在`main.ts`中全局引入 + ```js + import gUI from 'g-element-plus-components'; + import 'g-element-plus-components/style.css'; + + const app = createApp(App); + app.use(ElementPlus).use(gUI) + app.mount('#app') + ``` + +- 按需引入 + - 在`main.ts`中单个引入即可 + ```js + import GChooseArea from 'g-element-plus-components/choose-area' + import 'g-element-plus-components/choose-area/style.css' + + const app = createApp(App); + app.use(ElementPlus).use(GChooseArea) + app.mount('#app') + ``` diff --git a/docs/intro/index.md b/docs/intro/index.md new file mode 100644 index 0000000..90f148a --- /dev/null +++ b/docs/intro/index.md @@ -0,0 +1,6 @@ +## 介绍 +`g-element-plus-components`主要是基于`element-plus`库二次封装的业务型通用组件。主要的目的: +- `1.`通过简单的`json`化配置,可以快速形成业务所需组件,快速形成页面,提高开发效率。 +- `2.`支持组件再次拓展,易于再次定制化开发。 +- `3.`大大缩减了渲染页面的重复代码,有效地提高了代码质量,增强了代码可读性。 +- `4.`形成统一规范,便于管理。