进阶贡献
本教程参考自NCEPUwiki-进阶贡献
文件结构
写文章只需要关注docs/public/和有编号的文件夹,如01.新生入学/,其余内容请自行查看相关项目文档或者询问AI,但是修改需谨慎。
docs/public/里面是一些文章引用的图片等资源。图片放在docs/public/img/文件夹编号/文章编号,其余资源类似,以此类推。
以下结构并不全面,只显示一些比较重要的,更深入的了解网站结构请自行访问Github
text
NKUwiki/
├─ docs/ # 站点正文,最重要的目录
│ ├─ .vitepress/ # VitePress 配置、目录索引、主题和主页设置
│ ├─ public/ # 静态资源
│ │ └─ img/ # 图片资源
│ ├─ index.md
│ ├─ 01.新生入学/ # 面向新生的相关内容
│ │ ├─ 01.新生-入学准备.md
│ │ ├─ ...
│ │ └─ 10.Q&A.md
│ ├─ 02.浅谈学习/ # 学习专题
│ │ ├─ 01.学分绩点
│ │ └─ ...
│ ├─ ...
│ └─ 10.贡献与其他/ # 给贡献者看的协作说明项目贡献流程
Github Fork
如果你是第一次贡献,请先将项目Fork到个人仓库。

Fork后会在个人仓库看见NKUwiki Repository,即为Fork成功。
01.同步修改
由于Wiki更新频率较高,在进行修改前请先通过Sync fork同步他人的修改。

02.编辑内容
在同步之后,可以直接在Github网页对文件进行修改,如删除、添加,这种情况适用于自己先写好文章,最后只需要上传一下。

也可以使用Git工具(此工具的使用请参考文章Git教程),将项目clone到本地修改,最后在同步到个人仓库。

03.提交Pull Request
将修改内容同步到个人仓库后,点击仓库主页的Contribute -> Open pull request,即可将你的修改提交到NKUwiki主仓库,等待项目管理员审核批准,若有问题会及时评论,请及时修改。

更专业且详细的流程请参考文章结合Github、Vscode和git进行项目开发。