Skip to content

Commit 3a4fbad

Browse files
committed
docs(readme.md readme-zh.md): add the description section of commitlint & husky & commitizen
1 parent f4defba commit 3a4fbad

File tree

2 files changed

+23
-7
lines changed

2 files changed

+23
-7
lines changed

README-zh.md

Lines changed: 12 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -6,17 +6,25 @@
66

77
本项目目前采用 [MkDocs](https://github.com/mkdocs/mkdocs)[Material主题](https://squidfunk.github.io/mkdocs-material/) 部署在 [GitHub Pages](https://sdnuroboticsailab.github.io/) 上。
88

9-
如要在本地部署,需要有 `Python3` 环境,所需要的包见 `requirements.txt`
9+
如要在本地部署,需要有 `Python3` 环境,所需要的包见 [requirements.txt](requirements.txt)
1010

1111
本站已实现自动部署,无需先本地构建静态页面再 `push`
1212

1313
## 贡献
1414

15-
对于站内任何一部分,你若有想要增添/修正/删减等的内容,欢迎提出 [Pull Request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request-from-a-fork)
15+
对于站内任何一部分,你若有想要增添/修正/删减等的内容,欢迎提出 [Pull Request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request-from-a-fork)
1616

17-
若进行修改的是页面,请尽量确保文档遵守 [Markdown Rules](https://github.com/markdownlint/markdownlint/blob/main/docs/RULES.md)[Markdown 简体中文与西文混排要点](https://github.com/selfteaching/markdown-writing-with-mixed-cn-en),并且不要忘记修改 `mkdocs.yml``nav` 部分。
17+
本仓库采用 [commitlint](https://github.com/conventional-changelog/commitlint) + [husky](https://github.com/typicode/husky) 的方案自动进行 `commit message` 的审查,请确保 `commit message` 符合 [Conventional Commits](https://www.conventionalcommits.org/zh-hans/v1.0.0/) 规范。但也不必过多担心,本仓库已集成 [Commitizen](https://github.com/commitizen/cz-cli) 协助填写 `commit message` 。具体包及版本见 [package.json](package.json) ,在 `commit` 前请使用
1818

19-
本站支持中英双语,除非此功能经商讨后弃置,否则请确保每个页面至少有两个 `Markdown` 文件: `page.md` 以及 `page.en.md` ,同时注意添加 `mkdocs.yml``plugins` 中的 `i18n` 插件中的 `nav_translations` 部分。
19+
```bash
20+
npm install
21+
```
22+
23+
安装所有依赖。
24+
25+
若进行修改的是页面,请尽量确保文档遵守 [Markdown Rules](https://github.com/markdownlint/markdownlint/blob/main/docs/RULES.md)[Markdown 简体中文与西文混排要点](https://github.com/selfteaching/markdown-writing-with-mixed-cn-en),并且不要忘记修改 [mkdocs.yml](mkdocs.yml)`nav` 部分。
26+
27+
本站支持中英双语,除非此功能经商讨后弃置,否则请确保每个页面至少有两个 `Markdown` 文件: `page.md` 以及 `page.en.md` ,同时注意添加 `mkdocs.yml`[mkdocs.yml](mkdocs.yml) 中的 `i18n` 插件中的 `nav_translations` 部分。
2028

2129
若提交的页面中含有图片,请使用[此图床](https://github.com/SDNURoboticsAILab/ImageBed),推荐使用 [PicGo](https://picgo.github.io/PicGo-Doc/zh/guide/config.html#github%E5%9B%BE%E5%BA%8A) + [Typora](https://support.typora.io/Upload-Image/#picgoapp-chinese-language-only) 的方法。
2230

README.md

Lines changed: 11 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -6,17 +6,25 @@
66

77
This project is currently deployed on [GitHub Pages](https://sdnuroboticsailab.github.io/) using [MkDocs](https://github.com/mkdocs/mkdocs) and the [Material Theme](https://squidfunk.github.io/mkdocs-material/).
88

9-
To deploy locally, you need a `Python3` environment, and the required packages can be found in `requirements.txt`.
9+
To deploy locally, you need a `Python3` environment, and the required packages can be found in [requirements.txt](requirements.txt).
1010

1111
The site has automatic deployment in place, so there is no need to build static pages locally before pushing.
1212

1313
## Contribution
1414

1515
If you have any content you want to add, correct, or delete on this site, you are welcome to submit a [Pull Request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request-from-a-fork).
1616

17-
If you are modifying a page, please ensure that the document complies with [Markdown Rules](https://github.com/markdownlint/markdownlint/blob/main/docs/RULES.md) and [Markdown Writing with Mixed Chinese and English](https://github.com/selfteaching/markdown-writing-with-mixed-cn-en). Also, don't forget to update the `nav` section of `mkdocs.yml`.
17+
This repository uses the [commitlint](https://github.com/conventional-changelog/commitlint) + [husky](https://github.com/typicode/husky) solution to automatically review `commit messages`. Please ensure that your `commit messages` conform to the [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/) specification. However, don't worry too much, as this repository has integrated [Commitizen](https://github.com/commitizen/cz-cli) to assist in writing `commit messages`. For specific packages and versions, see [package.json](package.json). Before committing, please use
1818

19-
This site supports both Chinese and English. Unless this feature is abandoned after discussion, please ensure that each page has at least two `Markdown` files: `page.md` and `page.en.md`, and remember to add them to the `nav_translations` section of the `i18n` plugin in `mkdocs.yml`.
19+
```bash
20+
npm install
21+
```
22+
23+
to install all dependencies.
24+
25+
If you are modifying a page, please ensure that the document complies with [Markdown Rules](https://github.com/markdownlint/markdownlint/blob/main/docs/RULES.md) and [Markdown Writing with Mixed Chinese and English](https://github.com/selfteaching/markdown-writing-with-mixed-cn-en). Also, don't forget to update the `nav` section of [mkdocs.yml](mkdocs.yml).
26+
27+
This site supports both Chinese and English. Unless this feature is abandoned after discussion, please ensure that each page has at least two `Markdown` files: `page.md` and `page.en.md`, and remember to add them to the `nav_translations` section of the `i18n` plugin in [mkdocs.yml](mkdocs.yml).
2028

2129
If the pages you submit contain images, please use [this image bed](https://github.com/SDNURoboticsAILab/ImageBed). It is recommended to use the [PicGo](https://picgo.github.io/PicGo-Doc/zh/guide/config.html#github%E5%9B%BE%E5%BA%8A) + [Typora](https://support.typora.io/Upload-Image/#picgoapp-chinese-language-only) method.
2230

0 commit comments

Comments
 (0)