Menú
写博客文章与发布流程（仅在写文章任务时使用）
| name | blog-writing |
| description | 写博客文章与发布流程（仅在写文章任务时使用） |
本文档记录了在此博客项目中创建和发布新文章的完整流程。
根据首页定位，博客分为四个板块：
| 板块 | 目录 | 定位 | 内容特点 |
|---|---|---|---|
| 输入笔记 | input-notes/ | 外部输入转成自己的理解 | 看教程、文章、项目时的提取记录，不追求完整体系 |
| 实战手册 | practical-guides/ | 可照着操作的技术实践指南 | 下次做同类事情可以直接照着走，含独立篇和系列篇 |
| 专题研究 | research/ | 围绕一个问题深入钻研的系统性文章 | 持续补充，形成自己的判断框架 |
| 观点沉淀 | opinions/ | 经过思考后形成的长期判断与方法论 | 技术判断力 + 职业判断力 + 学习判断力 |
所有文章必须包含正确的 frontmatter：
---
title: 文章标题
date: YYYY-MM-DD
description: 文章简短描述（用于 SEO 和列表展示）
---
重要说明：
date 字段必须存在，否则文章不会出现在首页"近期发布"中date 使用 YYYY-MM-DD 格式（如：2025-11-13）description 建议控制在 50 字以内，简洁描述文章核心价值在对应目录创建 Markdown 文件（使用 kebab-case 命名）：
input-notes/my-new-article.md
practical-guides/my-new-guide.md
research/my-research-topic.md
opinions/my-opinion.md
对于系列文章，可使用子目录：
practical-guides/frontend-ai-infra/01-some-topic.md
确保包含正确的 title、date、description。
在对应目录的 index.md 中，按表格格式添加文章链接（使用相对路径）：
| [文章标题](./article-name) | 关键词1、关键词2 |
示例（输入笔记）：
| [代码定位能力](./code-location-ability) | 代码阅读、定位、调试 |
示例（专题研究，按分组）：
## 前端动画
| 文章 | 关键词 |
|------|--------|
| [CSS transition 与 animation 本质区别](./css-transition-vs-animation) | CSS、transition、animation |
注意：
./article-name.md 扩展名## 分组名 标题分隔编辑 .vitepress/config.mts，在对应板块的 sidebar 配置中添加文章：
普通文章（平级列表）：
'/input-notes/': [
{
text: '输入笔记',
items: [
{ text: '索引', link: '/input-notes/' },
{ text: '新文章标题', link: '/input-notes/new-article' }
]
}
],
带分组的文章（使用 collapsed 折叠）：
'/research/': [
{
text: '专题研究',
items: [
{ text: '索引', link: '/research/' },
{
text: '分组名称',
collapsed: true,
items: [
{ text: '文章标题', link: '/research/article-name' }
]
}
]
}
],
系列文章（子目录）：
{
text: '系列名称',
collapsed: true,
items: [
{ text: '系列概述', link: '/practical-guides/series-name/' },
{ text: '01 篇章标题', link: '/practical-guides/series-name/first-article' }
]
}
侧边栏配置要点：
text 是显示在侧边栏的标题link 使用绝对路径（以 / 开头），不含 .mdcollapsed: true 让分组默认折叠，保持侧边栏整洁/ 结尾"近期发布"组件由 .vitepress/data/recent-posts.data.mts 自动驱动：
.md 文件（排除 index.md）/my-blog/ 前缀input-notes → 输入笔记 等）无需手动修改此文件，除非新增板块目录。
date 字段YYYY-MM-DDindex.md（会被自动排除）./article，无 .md）/dir/article，无 .md）.vitepress/config.mts 中是否添加了对应条目.md）发布新文章前，确认以下事项：
./article，含关键词）.vitepress/config.mts，绝对路径 /dir/article）typescript、bash 等）