Blog 工作流

现在只维护文章本身

Blog 目录页会读取每篇文章顶部的元数据，自动完成日期排序、年份分组、标签筛选和链接生成。 不需要手动修改 Blog/index.md、HTML 时间轴或站点导航。

---

1. 目录结构

所有文章直接放在同一级：

docs/Blog/
├── index.md
├── OpenVLA.md
├── piano01.md
├── VLA技术架构.md
├── VLA训练流程.md
└── 绳驱灵巧手结构设计.md

不要再创建 daily-life/、paper-reading/ 等分类目录。分类由文章的 tags 表达。

---

2. 新建文章

在 docs/Blog/ 中创建一个 Markdown 文件，例如：

docs/Blog/新文章.md

文件开头填写：

---
title: 文章名字
date: 2026-07-26
label: 自定义标签
tags:
  - diary
  - survey
---

然后直接写正文：

# 文章名字

正文内容。

构建网站后，目录中会自动显示：

07-26  【自定义标签】文章名字

---

3. 字段说明

字段	是否必填	用途
title	是	Blog 目录和页面标题
date	是	自动排序和年份分组，格式为 YYYY-MM-DD
label	建议	标题前的 【自定义标签】；未填写时使用第一个 tags
tags	建议	顶部筛选标签；一篇文章可以有多个

当前常用筛选标签：

标签值	页面显示
diary	Diary
paper	Paper
survey	Survey
piano	Piano

如果写入新的标签值，它也会自动出现在 Blog 顶部。

---

4. 自动生成原理

hooks/blog_timeline.py 会在 MkDocs 构建时：

1. 扫描 docs/Blog/*.md；
2. 跳过 index.md；
3. 读取每篇文章的 front matter；
4. 按日期倒序排列；
5. 自动生成标签和时间轴。

因此新增、改名或删除文章时，都不需要维护另一份文章清单。

---

5. 检查与预览

mkdocs serve

新增文章后只需确认：

• 文件位于 docs/Blog/ 根目录；
• title 和 date 已填写；
• date 格式正确；
• label 是希望显示在 【】 中的文字；
• 标签筛选结果正确。