# 如何在本站添加自己的文章

## 一、前提条件

需要会基本的git操作

网上教程很多，推荐几个：

[【GeekHour】一小时Git教程](https://www.bilibili.com/video/BV1HM411377j/?spm_id_from=333.337.search-card.all.click&vd_source=cb3035aabee93b98268db84a2ab962fc)（很全，但要多练）

[『教程』一看就懂！Github基础教程](https://www.bilibili.com/video/BV1hS4y1S7wL?spm_id_from=333.788.videopod.sections&vd_source=cb3035aabee93b98268db84a2ab962fc)（超快速成，但只有最基础的命令）

[【大学生扫盲课】1 Git、GitHub 和 Gitee 完整讲解：从基础到进阶功能](https://www.bilibili.com/video/BV1G8CFYvEjt/?spm_id_from=333.337.search-card.all.click&vd_source=cb3035aabee93b98268db84a2ab962fc)（最符合大学生食用）

## 二、总流程

### 1. 将本站fork到自己的仓库中

本站gitee链接：https://gitee.com/liyongliu/electronicassociation_blogs.git

![image-20250122223156572](https://picture-note-1328988318.cos.ap-nanjing.myqcloud.com/Typora/202501222232055.png)

### 2. 将自己仓库clone到本地，进行添加修改

![image-20250122223447203](https://picture-note-1328988318.cos.ap-nanjing.myqcloud.com/Typora/202501222234440.png)

具体文件中需要添加修改哪些内容，稍后再详细讲解

### 3. 从自己本地仓库进行pr

pr：全称Pull Request(请求拉取)，向工程仓库管理者提交请求，拉取自己的仓库到工程仓库中进行合并，达到合作目的

![image-20250122223541103](https://picture-note-1328988318.cos.ap-nanjing.myqcloud.com/Typora/202501222235448.png)

> pr不会？

满老师视频手把手教学：https://www.bilibili.com/video/BV1gr4y1w7yX/?spm_id_from=333.999.0.0&vd_source=cb3035aabee93b98268db84a2ab962fc

rtthread文档中心：https://www.rt-thread.org/document/site/#/rt-thread-version/rt-thread-standard/development-guide/github/github

## 三、本站本地结构详解

我们在电脑本地clone好了仓库，文章都存在docs文件夹中，22信三李东泽...都是以目前的成员命名的文件夹，存放个人的学习笔记等个人博客，命名规则：班级+姓名。其他以英文命名的文件是一些公有文件，如git教程、学习路线、stm32教程等。

![image-20250122231417736](https://picture-note-1328988318.cos.ap-nanjing.myqcloud.com/Typora/202501222314825.png)

**我们添加文章主要修改2个文件：chapters文件夹下的.rst文件、添加子文件夹下我们的文章。**

![image-20250122232122611](https://picture-note-1328988318.cos.ap-nanjing.myqcloud.com/Typora/202501222321695.png)

![image-20250122232205611](https://picture-note-1328988318.cos.ap-nanjing.myqcloud.com/Typora/202501222322691.png)

### 1. 添加chapters文件夹下的.rst文件

> 注意：要和文件夹名一一对应

![image-20250122233058396](https://picture-note-1328988318.cos.ap-nanjing.myqcloud.com/Typora/202501222330542.png)

网站目录顺序和chapers文件夹中的.rst文件顺序对应，因此使用标号确定顺序，公有文件以01,02往下命名，个人文件以年级命名

> 注意：.rst文件必须为英文命名

![image-20250122234146900](https://picture-note-1328988318.cos.ap-nanjing.myqcloud.com/Typora/202501222341041.png)

### 2. 添加自己的文章

可以用markdown或reStructured格式写，子目录顺序和文件顺序一致。

## 四、总结

主要修改2个文件：chapters文件夹下的.rst文件、添加子文件夹下我们的文章。