仓库与发布流程

这篇页面用最简单的话说明这个仓库是怎么工作的。

两个部分

• main 是源码分支
• gh-pages 是已发布的网站分支

你平时要改的是 main 里的 Markdown 文件，不是 gh-pages 里的 HTML 文件。

网站是怎么生成的

1. 你编辑 main/content/ 里的 .md 文件，然后提交
2. 仓库把 Markdown 处理成网页内容
3. 构建后生成静态 HTML 和资源文件
4. 部署到 gh-pages

所以，Markdown 是“源文件”，gh-pages 是“网站成品”。

你应该改哪里

• 网站首页：content/index.md
• 说明文档：content/docs/*.md
• 新帖子：content/post/<帖子名>/index.md
• 帖子图片：放在同一个帖子文件夹里

如果你要更新一篇帖子，就直接修改那篇帖子的 .md 文件。

怎么上传帖子

如果你想新增或更新投稿，通常这样做。克隆repo到本地后(在 main 分支)：

1. 创建帖子目录，比如 content/post/<帖子名>/
2. 编辑里面的 index.md
3. 保存图片或附件到同一目录
4. 提交 main 分支的PR

如何更改网页主题色

在 src/.vitepress/theme/style.css 中进行颜色设置

如何更改右上角链接

在 src/.vitepress/config.ts 中进行设置