Skip to content

Commit 69579eb

Browse files
committed
feat: update README.md
1 parent 6077705 commit 69579eb

File tree

1 file changed

+80
-14
lines changed

1 file changed

+80
-14
lines changed

README.md

+80-14
Original file line numberDiff line numberDiff line change
@@ -1,39 +1,105 @@
1-
# vue3-element-admin
1+
## 简介
22

3-
This template should help get you started developing with Vue 3 in Vite.
3+
这个模板使用了最新的 vue3 和 element-plus UI 框架,vite 构建工具、pinia 状态管理、vue-router 路由管理、mockjs 数据模拟,并集成了 typescript。功能从 Vue Element Admin 移植而来,详细使用可以参考[该文档](https://vue3-element-admin-site.midfar.com/zh/guide/essentials/router-and-nav.html)
44

5-
## Recommended IDE Setup
5+
## 特性
66

7-
[VSCode](https://code.visualstudio.com/) + [Volar](https://marketplace.visualstudio.com/items?itemName=Vue.volar) (and disable Vetur).
7+
- **最新技术栈**:使用 Vue3/vite3 等前端前沿技术开发
8+
- **TypeScript**: 应用程序级 JavaScript 的语言
9+
- **Mock 数据** 内置 Mock 数据方案
10+
- **权限** 内置完善的动态路由权限生成方案
11+
- **组件** 二次封装了多个常用的组件
812

9-
## Type Support for `.vue` Imports in TS
13+
## 在线示例
1014

11-
TypeScript cannot handle type information for `.vue` imports by default, so we replace the `tsc` CLI with `vue-tsc` for type checking. In editors, we need [Volar](https://marketplace.visualstudio.com/items?itemName=Vue.volar) to make the TypeScript language service aware of `.vue` types.
15+
[vue3 element admin](https://vue3-element-admin.midfar.com/)
1216

13-
## Customize configuration
17+
[element plus](https://element-plus.midfar.com/)
1418

15-
See [Vite Configuration Reference](https://vitejs.dev/config/).
19+
## 准备
20+
开发前请确保熟悉并掌握以下技术栈:
1621

17-
## Project Setup
22+
- vue: https://cn.vuejs.org/
23+
- TypeScript:https://www.tslang.cn/index.html
24+
- element-plus:https://element-plus.midfar.com/
25+
- pinia: https://pinia.vuejs.org/zh/
26+
- vue-router: https://router.vuejs.org/zh/
27+
28+
注:开发前请务必阅读上述所有文档。应用至实际项目开发请修改 readme 内容。
29+
30+
## 推荐的 IDE 工具和插件
31+
32+
[VSCode](https://code.visualstudio.com/) + [Volar](https://marketplace.visualstudio.com/items?itemName=Vue.volar) (禁用 Vetur) + [TypeScript Vue Plugin (Volar)](https://marketplace.visualstudio.com/items?itemName=Vue.vscode-typescript-vue-plugin).
33+
34+
## Vite 构建工具配置
35+
36+
参考 [Vite 配置](https://vitejs.dev/config/).
37+
38+
## 主要结构
39+
40+
```
41+
- mock // 模拟数据
42+
- public
43+
- src
44+
- components // 组件
45+
- views // 页面
46+
- tableTemplates // 示例模块
47+
- index.ts
48+
- login // 登录模块
49+
- index.vue
50+
- settings.ts // 全局配置
51+
- main.ts // 入口文件
52+
- types // TypeScript类型
53+
- package.json
54+
- CODE_OF_CONDUCT.md // 框架开发要求
55+
- README.md //框架使用手册
56+
```
57+
58+
## 使用
59+
60+
### 安装依赖
1861

1962
```sh
2063
npm install
2164
```
2265

23-
### Compile and Hot-Reload for Development
66+
### 开发模式连接测试服
2467

2568
```sh
26-
npm run dev
69+
npm run dev:test
2770
```
2871

29-
### Type-Check, Compile and Minify for Production
72+
### 打包到测试服
3073

3174
```sh
32-
npm run build
75+
npm run build:test
3376
```
3477

35-
### Lint with [ESLint](https://eslint.org/)
78+
### 代码检查 [ESLint](https://eslint.org/)
3679

3780
```sh
3881
npm run lint
3982
```
83+
84+
## 支持环境
85+
86+
现代浏览器。
87+
88+
| IE/Edge | Firefox | Chrome | Safari |
89+
| ---------------- | --------------- | --------------- | --------------- |
90+
| IE10, IE11, Edge | last 2 versions | last 2 versions | last 2 versions |
91+
92+
## TODO
93+
94+
当前问题
95+
96+
- 暂未配置git提交规范。
97+
98+
## 参与贡献
99+
100+
我们非常欢迎你的贡献,你可以通过以下方式和我们一起共建基线框架:
101+
102+
- 联系维护人员 [email protected]
103+
- 提交 pr
104+
- 修复 bug
105+
- 分享实践案例

0 commit comments

Comments
 (0)