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

一、前提条件#

需要会基本的git操作

网上教程很多,推荐几个:

【GeekHour】一小时Git教程(很全,但要多练)

『教程』一看就懂!Github基础教程(超快速成,但只有最基础的命令)

【大学生扫盲课】1 Git、GitHub 和 Gitee 完整讲解:从基础到进阶功能(最符合大学生食用)

二、总流程#

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

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

image-20250122223156572

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

image-20250122223447203

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

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

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

image-20250122223541103

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

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

image-20250122232122611

image-20250122232205611

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

注意:要和文件夹名一一对应

image-20250122233058396

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

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

image-20250122234146900

2. 添加自己的文章#

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

四、总结#

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