English | Chinese
你好！欢迎使用 fighting-design！
我很高兴你有兴趣为 fighting-design 做贡献。在提交您的贡献之前，请务必花点时间阅读以下指南。
规范可能比较多，但是大多数都是一些比较细小的规范，请认真阅读。
众所周知，在市面上的组件库有很多，很多时候我们需要开发的新组件在市面上早已经开发好了，但是请勿直接复制其它第三方源码进行使用！
开发组件库本身是一个学习进步的过程，不要仅仅是为了新增组件而新增组件，希望各位参与者可以在新增组件过程中学习到一些东西来提升自己的技术。如果在开发阶段的某个功能遇到了困难，你可以发起一个讨论，或者也可以直接联系我或在群里求助，当然去学习参考其它开源库也是可以的，只是希望你在写的时候，是已经理解了问题，自己来动手实践的。
在贡献之前，你需要先将 fighting-design 项目跑起来才行，那么前期的准备你需要：
如果你已经做好了前面的准备，可以直接跳过，从这里开始：
- Fork fighting-design
接下来执行命令：
# clone 项目
git clone git@github.com:FightingDesign/fighting-design.git
# 进入项目目录
cd fighting-design
# 安装依赖项
pnpm i
# 启动开发项目
pnpm start
# 启动文档
pnpm dev:docs请先阅读 IDE 支持
编辑器强烈推荐使用 Visual Studio Code，内置插件请务必安装以下几款：
- Vue - Official Vue3 官方开发插件
- ESLint 代码格式校验，如果不安装，那么 fighting-eslint-config 则不生效
- Code Spell Checker 用于检测单词拼写错误
fighting-design 内部设置了很多的命令，在 package.json 中可进行查看。下面详细介绍每一条命令：
| script 字段 | 对应命令 | 命令说明 |
|---|---|---|
clear |
pnpm clear |
清除 dist 打包目录 |
start |
pnpm start |
启动测试开发项目 start |
dev:play |
pnpm dev:play |
启动演练场项目 fighting-playground |
dev:docs |
pnpm dev:docs |
启动文档项目 docs |
build |
pnpm build |
命令集合。打包所有组件、样式、类型。打包出来的就是最终需要发布的包 执行配置文件 vite.config.ts |
build:css |
pnpm build:css |
分别打包组件的样式，执行配置文件 vite.config.css.ts |
build:theme |
pnpm build:theme |
打包完整的主题样式，执行配置文件 vite.config.theme.ts |
build:icon |
pnpm build:icon |
打包 fighting-icon，执行配置文件 vite.config.icon.ts |
build:docs |
pnpm build:docs |
打包文档项目 docs |
build:start |
pnpm build:start |
打包 start 测试项目 start |
build:play |
pnpm build:play |
打包 演练场 项目 fighting-playground |
serve:docs |
pnpm serve:docs |
预览打包后的文档 |
new |
pnpm new xxx |
构建全新组件，生产组件所需要的文件，执行配置文件 index.ts，详情参考 README.md |
test |
pnpm test |
执行单元测试 |
test:coverage |
pnpm test:coverage |
查看单元测试覆盖率，可在终端中生成覆盖率，也可查看项目根目录下的 coverage/index.html，参考 Coverage |
test:ui |
pnpm test:ui |
提供了一个可视化的界面来查看单元测试并与之交互，参考 Vitest UI |
prettier |
pnpm prettier |
全局格式化 |
commit |
pnpm commit |
commit 钩子 |
lint |
pnpm lint |
全局 eslint 检测，规则参考 |
lint:fix |
pnpm lint:fix |
全局 eSLint 检测 + 修复 |
changelog |
pnpm changelog |
同步文档的更新日志 |
ver |
pnpm ver x.x.x |
设置新的版本号 |
format |
pnpm format |
全局格式化 + 修复 |
主要源文件都在 packages 目录下，其中每个子目录都有单独的 README.md 对指定目录进行说明，每个模块详细的规范参考下面文档：
详细的规范在下面链接，千万不要忽略下面链接！！！
详细的规范在下面链接，千万不要忽略下面链接！！！
详细的规范在下面链接，千万不要忽略下面链接！！！
- fighting-add-component 创建新组件
- fighting-design 组件源文件目录
- fighting-theme 样式主题目录
- fighting-eslint-config Eslint 配置项
- docs 文档编写规范
Git 允许我们在每次提交时，附带一个提交信息作为说明，当执行 commit 的时候，需要严格按照下方说明规范进行填写说明信息，提交信息必须是下面信息中的一个，后面跟随 英文的冒号 + 空格 + 信息
例如：
git commit -m 'feat: 新增 xxx 功能'类型必须是下面类型之一，并对照类型描述填写。
| 类型 | 描述 |
|---|---|
build |
打包 |
chore |
改变构建流程或者增加依赖库、工具等 |
ci |
CI 相关更改 |
docs |
文档改变 |
feat |
新功能 |
fix |
修复 |
perf |
性能优化 |
refactor |
既不修复错误也不添加功能的代码更改 |
revert |
发布新版本 |
style |
标记、空格、格式、缺少分号 |
test |
增加测试/测试用例 |
但 fighting-design 内置了 commitlint 插件可以辅助我们进行添加提交信息，那么就需要执行下面命令：
git add .
# 使用插件的提示来设置提交信息
pnpm commit
git push在你提交 PR 之前，请务必保证你 fork 的仓库是当前最新的代码，以免发生冲突。
如果你并不了解如何提交 PR，可以参考我这篇文章 Github 如何提交 PR？
开发不易，欢迎大家赞助！
感谢所有已经为 fighting-design 做出贡献的人！