2023-04-02 18:53:54 +02:00
|
|
|
|
_选择合适的语言阅读: [西班牙语](/docs/CONTRIBUTING.es.md), [英语](/CONTRIBUTING.md), [简体中文](/docs/CONTRIBUTING.zh-cn.md)_
|
2023-04-02 18:49:03 +02:00
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
|
|
# 提交贡献
|
|
|
|
|
|
|
|
|
|
|
|
我们非常感谢你 ❤️ 为 Pingvin Share 提交贡献使其变得更棒! 欢迎任何形式的贡献，包括 issues, 建议, PRs 和其他形式
|
|
|
|
|
|
|
|
|
|
|
|
## 小小的开始
|
|
|
|
|
|
|
|
|
|
|
|
你找到了一个 bug，有新特性建议或者其他提议，请在 GitHub 建立一个 issue 以便我和你联络 😊
|
|
|
|
|
|
|
|
|
|
|
|
## 提交一个 Pull Request
|
|
|
|
|
|
|
|
|
|
|
|
在你提交 PR 前请确保
|
|
|
|
|
|
|
|
|
|
|
|
- PR 的名字遵守 [Conventional Commits specification](https://www.conventionalcommits.org):
|
|
|
|
|
|
|
|
|
|
|
|
`<type>[optional scope]: <description>`
|
|
|
|
|
|
|
|
|
|
|
|
例如:
|
|
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
feat(share): add password protection
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
`TYPE` 可以是:
|
|
|
|
|
|
|
|
|
|
|
|
- **feat** - 这是一个新特性 feature
|
|
|
|
|
|
- **doc** - 仅仅改变了文档部分 documentation
|
|
|
|
|
|
- **fix** - 修复了一个 bug
|
|
|
|
|
|
- **refactor** - 更新了代码，但是并非出于增加新特性 feature 或修复 bug 的目的
|
|
|
|
|
|
|
|
|
|
|
|
- 请在 PR 中附详细的解释说明
|
|
|
|
|
|
- 使用 `npm run format` 格式化你的代码
|
|
|
|
|
|
|
|
|
|
|
|
<details>
|
|
|
|
|
|
<summary>不知道怎么发起一个 PR？ 点开了解怎么发起一个 PR </summary>
|
|
|
|
|
|
|
|
|
|
|
|
1. 点击 Pingvin Share 仓库的 `Fork` 按钮，复制一份你的仓库
|
|
|
|
|
|
|
|
|
|
|
|
2. 通过 `git clone` 将你的仓库克隆到本地
|
|
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
$ git clone https://github.com/[你的用户名]/pingvin-share
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
3. 进行你的修改 - 提交 commit 你的修改 - 重复直到完成
|
|
|
|
|
|
|
|
|
|
|
|
4. 将你的修改提交到 GitHub
|
|
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
$ git push origin [你的新分支的名字]
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
5. 提交你的代码以便代码审查
|
|
|
|
|
|
|
2023-04-02 18:53:54 +02:00
|
|
|
|
如果你进入你 fork 的 Github 仓库，你会看到一个 `Compare & pull request` 按钮，点击该按钮
|
|
|
|
|
|
|
2023-04-02 18:49:03 +02:00
|
|
|
|
6. 发起一个 PR
|
|
|
|
|
|
7. 点击 `Create pull request` 来提交你的 PR
|
|
|
|
|
|
8. 等待代码审查，通过或以某些原因拒绝
|
|
|
|
|
|
|
|
|
|
|
|
</details>
|
|
|
|
|
|
|
|
|
|
|
|
## 配置开发项目
|
|
|
|
|
|
|
|
|
|
|
|
Pingvin Share 包括前端和后端部分
|
|
|
|
|
|
|
|
|
|
|
|
### 后端
|
|
|
|
|
|
|
|
|
|
|
|
后端使用 [Nest.js](https://nestjs.com) 建立，使用 Typescript
|
|
|
|
|
|
|
|
|
|
|
|
#### 搭建
|
|
|
|
|
|
|
|
|
|
|
|
1. 打开 `backend` 文件夹
|
|
|
|
|
|
2. 使用 `npm install` 安装依赖
|
|
|
|
|
|
3. 通过 `npx prisma db push` 配置数据库结构
|
|
|
|
|
|
4. 通过 `npx prisma db seed` 初始化数据库数据
|
|
|
|
|
|
5. 通过 `npm run dev` 启动后端
|
|
|
|
|
|
|
|
|
|
|
|
### 前端
|
|
|
|
|
|
|
|
|
|
|
|
后端使用 [Next.js](https://nextjs.org) 建立，使用 Typescript
|
|
|
|
|
|
|
|
|
|
|
|
#### 搭建
|
|
|
|
|
|
|
|
|
|
|
|
1. 首先启动后端
|
|
|
|
|
|
2. 打开 `frontend` 文件夹
|
|
|
|
|
|
3. 通过 `npm install` 安装依赖
|
|
|
|
|
|
4. 通过 `npm run dev` 启动前端
|
|
|
|
|
|
|
|
|
|
|
|
开发项目配置完成
|
|
|
|
|
|
|
|
|
|
|
|
### 测试
|
|
|
|
|
|
|
|
|
|
|
|
目前阶段我们只有后端的系统测试，在 `backend` 文件夹运行 `npm run test:system` 来执行系统测试
|
