提交 70e83100 编写于 作者: EvanOne(文一)'s avatar EvanOne(文一)

docs: Add doc for contribution

上级 323f12d0
......@@ -31,7 +31,7 @@
</a>
</p>
[English](https://github.com/liuyib/hexo-theme-stun/blob/master/README_en-US.md) | [中文简体](https://github.com/liuyib/hexo-theme-stun/blob/master/README.md)
语言: [English](https://github.com/liuyib/hexo-theme-stun/blob/master/README_en-US.md) | [中文简体](https://github.com/liuyib/hexo-theme-stun/blob/master/README.md)
## :sparkles: 演示
......@@ -46,7 +46,7 @@
- [MikyMing's Blog](https://mikyming.online/)
- [maple Blog](https://www.hongmaple.xyz/)
如果你正在使用 Stun 主题,并希望展示在这里,你只需修改 [README](https://github.com/liuyib/hexo-theme-stun/edit/master/README.md) 填入你的网站,然后提交 PR 即可。
如果你准备长期使用 «Stun» 主题,并希望展示在这里,你只需在 [README](https://github.com/liuyib/hexo-theme-stun/edit/master/README.md)填入你的网站,然后提交 PR 即可。
## :crystal_ball: 特性
......@@ -68,7 +68,7 @@
## :package: 安装
- 安装 Stun
- 安装 «Stun»
进入 Hexo 根目录,执行指令:
......@@ -114,12 +114,22 @@ $ git pull
如果遇到问题,首先请仔细阅读[文档](https://liuyib.github.io/hexo-theme-stun/zh-CN/),或者查看[常见问题](https://github.com/liuyib/hexo-theme-stun/blob/master/FAQ.md)。当以上的方法都无法帮助你时,再去提出 `issue`:hugs:。
## :handshake: 贡献
在提出 Pull request 之前,请务必先阅读[贡献指南](https://liuyib.github.io/hexo-theme-stun/zh-CN/contribute/)
感谢所有为 «Stun» 做出贡献的人!
<a href="https://github.com/liuyib/hexo-theme-stun/graphs/contributors">
<img src="https://opencollective.com/hexo-theme-stun/contributors.svg?width=980">
</a>
## :computer: 浏览器支持
| <img src="https://raw.githubusercontent.com/liuyib/picBed/master/collection/20190723235410.png" alt="IE" width="32px" height="32px" /></br> IE | <img src="https://cdnjs.cloudflare.com/ajax/libs/browser-logos/35.1.0/edge/edge_64x64.png" alt="Edge" width="32px" height="32px" /></br> Edge | <img src="https://raw.githubusercontent.com/liuyib/picBed/master/collection/20190723235406.png" alt="Firefox" width="32px" height="32px" /></br> Firefox | <img src="https://raw.githubusercontent.com/liuyib/picBed/master/collection/20190723235407.png" alt="Chrome" width="32px" height="32px" /></br> Chrome | <img src="https://raw.githubusercontent.com/liuyib/picBed/master/collection/20190723235409.png" alt="Safari" width="32px" height="32px" /></br> Safari | <img src="https://raw.githubusercontent.com/liuyib/picBed/master/collection/20190723235411.png" alt="Opera" width="32px" height="32px" /></br> Opera |
| :---: | :---: | :---: |:---: | :---: | :---: |
| Not Supported | 12+ | 41+ | 45+ | 10+ | 32+ |
## :handshake: 开源协议
## :page_with_curl: 开源协议
[MIT](https://github.com/liuyib/hexo-theme-stun/blob/master/LICENSE) Copyright (c) 2020 liuyib
......@@ -31,7 +31,7 @@
</a>
</p>
[English](https://github.com/liuyib/hexo-theme-stun/blob/master/README_en-US.md) | [中文简体](https://github.com/liuyib/hexo-theme-stun/blob/master/README.md)
Language: [English](https://github.com/liuyib/hexo-theme-stun/blob/master/README_en-US.md) | [中文简体](https://github.com/liuyib/hexo-theme-stun/blob/master/README.md)
## :sparkles: Demo
......@@ -46,7 +46,7 @@
- [MikyMing's Blog](https://mikyming.online/)
- [maple Blog](https://www.hongmaple.xyz/)
If you are using the `Stun` theme and want to show it here, you just need to modify the [README_en-US](https://github.com/liuyib/hexo-theme-stun/edit/master/README_en-US.md) to fill in your website and submit PR.
If you plan to use «Stun» theme for a long time and want to show it here, you just need to modify the [README_en-US](https://github.com/liuyib/hexo-theme-stun/edit/master/README_en-US.md) to fill in your website and submit PR.
## :crystal_ball: Feature
......@@ -114,12 +114,22 @@ Please see: [https://liuyib.github.io/hexo-theme-stun/](https://liuyib.github.io
If you have problems, please read [documentation](https://liuyib.github.io/hexo-theme-stun/zh-CN/) firstly, or check [FAQ](https://github.com/liuyib/hexo-theme-stun/blob/master/FAQ.md). You can open an `issue` when the above methods can't help you :hugs:.
## :handshake: Contribution
Please make sure to read the [Contributing Guide](https://liuyib.github.io/hexo-theme-stun/contribute/) before making a pull request.
Thank you to all the people who have already contributed to «Stun»!
<a href="https://github.com/liuyib/hexo-theme-stun/graphs/contributors">
<img src="https://opencollective.com/hexo-theme-stun/contributors.svg?width=980">
</a>
## :computer: Browser Support
| <img src="https://raw.githubusercontent.com/liuyib/picBed/master/collection/20190723235410.png" alt="IE" width="32px" height="32px" /></br> IE | <img src="https://cdnjs.cloudflare.com/ajax/libs/browser-logos/35.1.0/edge/edge_64x64.png" alt="Edge" width="32px" height="32px" /></br> Edge | <img src="https://raw.githubusercontent.com/liuyib/picBed/master/collection/20190723235406.png" alt="Firefox" width="32px" height="32px" /></br> Firefox | <img src="https://raw.githubusercontent.com/liuyib/picBed/master/collection/20190723235407.png" alt="Chrome" width="32px" height="32px" /></br> Chrome | <img src="https://raw.githubusercontent.com/liuyib/picBed/master/collection/20190723235409.png" alt="Safari" width="32px" height="32px" /></br> Safari | <img src="https://raw.githubusercontent.com/liuyib/picBed/master/collection/20190723235411.png" alt="Opera" width="32px" height="32px" /></br> Opera |
| :---: | :---: | :---: |:---: | :---: | :---: |
| Not Supported | 12+ | 41+ | 45+ | 10+ | 32+ |
## :handshake: License
## :page_with_curl: License
[MIT](https://github.com/liuyib/hexo-theme-stun/blob/master/LICENSE) Copyright (c) 2019 liuyib
## Contribute
## <div align="center" style="color: #73c8ff;font-size: 36px;"><a title="Go to homepage" href="https://github.com/liuyib/hexo-theme-stun"><img align="center" width="60" height="60" src="https://raw.githubusercontent.com/liuyib/hexo-theme-stun/master/source/images/icons/stun-logo.svg?sanitize=true"></a> t u n</div>
Please follow the workflow below to contribute:
Hi! I'm really excited that you are interested in contributing to «Stun». Before submitting your contribution, please make sure to take a moment and read through the following guidelines:
- [Pull Request Guidelines](#pull-request-guidelines)
- [Development Setup](#development-setup)
- [Commit Messages Rules](#commit-messages-rules)
### Pull Request Guidelines
The `master` branch is just a snapshot of the latest stable release. All development should be done in dedicated branches. **Do not submit PRs against the `master` branch**.
- Fork the repository to your Github and clone it.
- Switch to a **new branch** to develop (direct development on the `master` branch is prohibited).
- Submit changes locally.
- Switch to a **new branch** (e.g. `patch-1`) to develop.
- Submit changes locally (If you modified source code, please run `npm run lint:fix`).
- Push the commit to the repository of fork.
- Create a Pull request to the **dev branch** of the Stun theme repository.
### Development Setup
You need to install [Node.js](http://nodejs.org/) and [npm](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm).
After cloning the repo, run:
```bash
$ npm install
```
### Commit Messages Rules
We agree on the format of Git commit information, and each commit information is composed of `type` + `subject`, which will improve the readability of the project log.
- `type` Describes the meaning of this submission, all lowercase, including only the following types:
- `feat`: A new feature
- `fix`: A bug fix
- `refactor`: A code change that neither adds a feature nor fixes a bug
- `docs`: Documentation only changes
- `style`: Code format changes (white-space, indentation, line breaks, semicolons, etc.)
- `test`: Code test correlation
- `chore`: Changes to basic build tools or dependent libraries (no source code involved)
- `revert`: Revert some existing commits
- `subject` contains a succinct description of the change, like `Update quick start in readme.md`
- No dot (`.`) at the end
- Use the imperative, present tense ("change" not "changed" nor "changes")
### Contributors
Thank you to all the people who have already contributed to «Stun»!
<a href="https://github.com/liuyib/hexo-theme-stun/graphs/contributors">
<img src="https://opencollective.com/hexo-theme-stun/contributors.svg?width=980">
</a>
## 参与贡献
## <div align="center" style="color: #73c8ff;font-size: 36px;"><a title="Go to homepage" href="https://github.com/liuyib/hexo-theme-stun"><img align="center" width="60" height="60" src="https://raw.githubusercontent.com/liuyib/hexo-theme-stun/master/source/images/icons/stun-logo.svg?sanitize=true"></a> t u n</div>
### Pull request 流程
嗨!我很高兴您有兴趣为 «Stun» 做贡献。在进行贡献之前,请务必花一些时间通读以下准则:
请严格按照以下工作流参与贡献:
- [Pull request 准则](#pull-request-%e5%87%86%e5%88%99)
- [开发之前的准备](#%e5%bc%80%e5%8f%91%e4%b9%8b%e5%89%8d%e7%9a%84%e5%87%86%e5%a4%87)
- [提交信息规范](#%e6%8f%90%e4%ba%a4%e4%bf%a1%e6%81%af%e8%a7%84%e8%8c%83)
### Pull request 准则
要知道,`master` 分支只是最新稳定版本的一个快照。所有的开发都应该在专门的分支中进行,**不要向 `master` 分支提交 PRs**
- 将仓库 fork 到你的 Github,并 clone 到本地
- 切换到**新分支**上开发(禁止直接在 master 分支上开发)
- 将本地修改进行提交
- 切换到**新分支**(例如 `patch-1`)上开发
- 将本地修改进行提交(如果你修改了源代码,请执行 `npm run lint:fix`
- 将提交 push 到 fork 的仓库下
- 创建一个 Pull request 到 Stun 主题仓库的 **dev 分支**
### 开发之前的准备
你需要安装 [Node.js](http://nodejs.org/)[npm](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm)
在 clone 该仓库后,执行:
```bash
$ npm install
```
### 提交信息规范
我们对项目的 git 提交信息格式进行统一格式约定,每条提交信息由 `type` + `subject` 组成,这将提升项目日志的可读性。
- `type` 用于表述此次提交信息的意义,全小写,仅包括如下类型:
- `feat`:新功能
- `fix`:Bug 修复
- `refactor`:重构(既不是新增功能,也不是修改 Bug 的代码变动)
- `docs`:文档变化
- `style`:代码格式变化(空格、缩进、换行、分号等)
- `test`:代码测试相关
- `chore`:基础构建工具或依赖库的变化(不涉及源码)
- `revert`:代码回滚(回退已经存在的 `commit`
- `subject` 用于简要描述修改变更的内容,如 `Update quick start in readme.md`
- 句尾不要使用符号
- 使用现在时、祈使句语气
### 贡献者
感谢所有为 «Stun» 做出贡献的人!
<a href="https://github.com/liuyib/hexo-theme-stun/graphs/contributors">
<img src="https://opencollective.com/hexo-theme-stun/contributors.svg?width=980">
</a>
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册