|
6 | 6 |
|
7 | 7 | 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/).
|
8 | 8 |
|
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). |
10 | 10 |
|
11 | 11 | The site has automatic deployment in place, so there is no need to build static pages locally before pushing.
|
12 | 12 |
|
13 | 13 | ## Contribution
|
14 | 14 |
|
15 | 15 | 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).
|
16 | 16 |
|
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 |
18 | 18 |
|
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). |
20 | 28 |
|
21 | 29 | 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.
|
22 | 30 |
|
|
0 commit comments