本指南将引导您完成在本博客上发布一篇新文章的完整流程。当前博客的首页布局是基于“主题卡片”的，所以发布一篇新文章的核心是：将文章添加到指定的主题中。
场景假设
我们要将一篇写好的、名为 “Tensor基础” 的笔记，添加到 “分布式训练笔记” 这个主题下。
第一步：准备文章和图片
- 准备文章文件:
- 确保您的文章是 Markdown 格式 (
.md)。 - 文件名必须严格遵守
YYYY-MM-DD-your-post-title.md的格式。例如，我们的文章文件名为2025-11-03-tensor-basics.md。
- 确保您的文章是 Markdown 格式 (
- 准备文章内图片 (可选):
- 如果您的文章内部需要引用图片，建议在
img/目录下为这篇文章创建一个专属的子文件夹，例如img/tensor-basics/。 - 将所有文章内图片（例如
image1.png）放入这个文件夹。 - 在文章中引用它们时，请使用以斜杠开头的绝对路径，例如：
。
- 如果您的文章内部需要引用图片，建议在
第二步：将文章添加到主题中
这是最关键的一步。
-
打开数据文件: 打开项目根目录下的
_data/homepage_groups.yml文件。 -
找到目标主题: 在文件中找到您希望添加文章的目标主题，即
“分布式训练笔记”。 -
添加文章文件名: 在该主题的
posts:列表下，添加您的文章文件名，像这样：- group_name: "分布式训练笔记" group_image: "/img/cover-llms.png" group_description: "LLMs在多卡服务器上的训练" posts: - "2025-11-03-tensor-basics.md" # <--- 在这里添加新文章的文件名
第三步：上传文章文件
将您准备好的文章文件 2025-11-03-tensor-basics.md 放入项目根目录的 _posts 文件夹下。
第四步：提交所有更改
完成以上所有步骤后，将所有新建和修改的文件（_data/homepage_groups.yml 和 _posts 里的新文章）提交到您的 GitHub 仓库即可。几分钟后，您的新文章就会出现在对应的“主题页面”下了。
总结： 现在的流程非常简单，您只需要关心两件事：
- 把文章文件放到
_posts目录。 - 在
_data/homepage_groups.yml文件中，把文章文件名“挂靠”到您想要的主题下面。
