diff --git a/README.md b/README.md index d1571e9..3c07ff9 100644 --- a/README.md +++ b/README.md @@ -14,103 +14,85 @@

-### 项目简介 +English | [简体中文](./README-zh_CN.md) +### Introduction -TDesign Vue Starter 是一个基于 tdesign-vue，使用 `Vue2`、`Vite2`开发，可进行个性化主题配置，旨在提供项目开箱即用的、配置式的中后台项目。 +TDesign Vue Starter is a TDesign-based project developed with `Vue2`, `Vite`. It can be customized theme configuration, and aims to provide project out-of-the-box, configuration-style middle and background projects.

- 在线预览 + Live Preview · - 使用文档 - + Documentation

-### 特性 +### Features -- 内置多种常用的中后台页面 -- 完善的目录结构 -- 完善的代码规范配置 -- 支持暗黑模式 -- 自定义主题颜色 -- 多种空间布局 -- 内置 Mock 数据方案 +- Various provided pages for develop +- Complete directory structure for develop +- Code specification configuration +- Support dark mode +- Custom theme colors +- Various space layouts +- Mock data scheme -### 使用 +### Usage -> 通过 [tdesign-starter-cli](https://www.npmjs.com/package/tdesign-starter-cli) 初始化项目仓库 +> Initialize project with our CLI tool `tdesign-starter-cli` ```bash -## 1、安装 tdesign-starter-cli +## install tdesign-starter-cli npm i tdesign-starter-cli@latest -g -## 2、创建项目 +## create project td-starter init ``` -### 开发 +### Develop ```bash -## 安装依赖 +## install dependencies npm install -## 启动项目 +## set up npm run dev ``` -### 构建 +### Build ```bash -## 构建正式环境 +## build npm run build -## 构建测试环境 +## build for test npm run build:test ``` -### 其他 - -```bash -## 预览构建产物 -npm run preview - -## 代码格式检查 -npm run lint - -## 代码格式检查与自动修复 -npm run lint:fix - -## style格式检查 -npm run stylelint - -## style格式检查与自动修复 -npm run stylelint:fix -``` -### 如何贡献 +### Contributing Guide -非常欢迎您的贡献！提交您的 [Issue](https://github.com/tencent/tdesign-vue-starter/issues/new/choose) 或者提交 [Pull Request](https://github.com/Tencent/tdesign-vue-starter/pulls)。 +We welcome contributions to our project. Create your [Issue](https://github.com/tencent/tdesign-vue-starter/issues/new/choose) or Submit your [Pull Request](https://github.com/Tencent/tdesign-vue-starter/pulls). #### Pull Request -1. Fork 代码! -2. 创建自己的分支: `git checkout -b feat/xxxx` -3. 提交你的修改: `git commit -a 'feat(project): describe'` -4. 推送您的分支: `git push origin feat/xxxx` -5. 提交 `pull request` +1. Fork it! +2. Create your branch: `git checkout -b feat/xxxx` +3. Commit: `git commit -a 'feat(project): describe'` +4. Push: `git push origin feat/xxxx` +5. New Pull Request `pull request` -#### 贡献提交规范 +#### Commit Specification - [Angular Convention](https://github.com/conventional-changelog/conventional-changelog/tree/master/packages/conventional-changelog-angular) - [Vue Style Guide](https://v3.vuejs.org/style-guide/#rule-categories) -### 兼容性 +### Compatibility | [IE / Edge](http://godban.github.io/browsers-support-badges/)
IE / Edge | [Firefox](http://godban.github.io/browsers-support-badges/)
Firefox | [Chrome](http://godban.github.io/browsers-support-badges/)
Chrome | [Safari](http://godban.github.io/browsers-support-badges/)
Safari | | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| Edge >=84 | Firefox >=83 | Chrome >=84 | Safari >=14.1 | +| Edge >=84 | Firefox >=83 | Chrome >=84 | Safari >=14.1 | -### 开源协议 +### License -TDesign 遵循 [MIT 协议](https://github.com/Tencent/tdesign-vue-starter/LICENSE)。 +The MIT License. Please see [the license file](LICENSE) for more information. diff --git a/README_zh-CN.md b/README_zh-CN.md new file mode 100644 index 0000000..3b34033 --- /dev/null +++ b/README_zh-CN.md @@ -0,0 +1,118 @@ +

+ +

+

+ + TDesign Logo + +

+ +

+ node compatility + + License + +

+ +简体中文 | [English](./README.md) + +### 项目简介 + +TDesign Vue Starter 是一个基于 tdesign-vue，使用 `Vue2`、`Vite`开发，可进行个性化主题配置，旨在提供项目开箱即用的、配置式的中后台项目。 + +

+ 在线预览 + · + 使用文档 + +

+ + + +### 特性 + +- 内置多种常用的中后台页面 +- 完善的目录结构 +- 完善的代码规范配置 +- 支持暗黑模式 +- 自定义主题颜色 +- 多种空间布局 +- 内置 Mock 数据方案 + +### 使用 + +> 通过 [tdesign-starter-cli](https://www.npmjs.com/package/tdesign-starter-cli) 初始化项目仓库 + +```bash +## 1、安装 tdesign-starter-cli +npm i tdesign-starter-cli@latest -g + +## 2、创建项目 +td-starter init +``` + +### 开发 + +```bash +## 安装依赖 +npm install + +## 启动项目 +npm run dev +``` + +### 构建 + +```bash +## 构建正式环境 +npm run build + +## 构建测试环境 +npm run build:test +``` + +### 其他 + +```bash +## 预览构建产物 +npm run preview + +## 代码格式检查 +npm run lint + +## 代码格式检查与自动修复 +npm run lint:fix + +## style格式检查 +npm run stylelint + +## style格式检查与自动修复 +npm run stylelint:fix +``` + +### 如何贡献 + +非常欢迎您的贡献！提交您的 [Issue](https://github.com/tencent/tdesign-vue-starter/issues/new/choose) 或者提交 [Pull Request](https://github.com/Tencent/tdesign-vue-starter/pulls)。 + +#### Pull Request + +1. Fork 代码! +2. 创建自己的分支: `git checkout -b feat/xxxx` +3. 提交你的修改: `git commit -a 'feat(project): describe'` +4. 推送您的分支: `git push origin feat/xxxx` +5. 提交 `pull request` + +#### 贡献提交规范 + +- [Angular Convention](https://github.com/conventional-changelog/conventional-changelog/tree/master/packages/conventional-changelog-angular) +- [Vue Style Guide](https://v3.vuejs.org/style-guide/#rule-categories) + +### 兼容性 + +| [IE / Edge](http://godban.github.io/browsers-support-badges/)
IE / Edge | [Firefox](http://godban.github.io/browsers-support-badges/)
Firefox | [Chrome](http://godban.github.io/browsers-support-badges/)
Chrome | [Safari](http://godban.github.io/browsers-support-badges/)
Safari | +| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Edge >=84 | Firefox >=83 | Chrome >=84 | Safari >=14.1 | + +### 开源协议 + +TDesign 遵循 [MIT 协议](https://github.com/Tencent/tdesign-vue-starter/LICENSE)。