mirror of
https://github.com/stonith404/pingvin-share.git
synced 2024-11-19 22:00:12 +01:00
98 lines
2.6 KiB
Markdown
98 lines
2.6 KiB
Markdown
_选择合适的语言阅读: [西班牙语](/docs/CONTRIBUTING.es.md), [英语](/CONTRIBUTING.md), [简体中文](/docs/CONTRIBUTING.zh-cn.md)_
|
||
|
||
---
|
||
|
||
# 提交贡献
|
||
|
||
我们非常感谢你 ❤️ 为 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. 提交你的代码以便代码审查
|
||
|
||
如果你进入你 fork 的 Github 仓库，你会看到一个 `Compare & pull request` 按钮，点击该按钮
|
||
|
||
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` 来执行系统测试
|