博客文章目录
这个目录负责什么
- 按年份保存 Gatsby 处理的文章 Markdown 源文件。
- 相对图片与附件资源由文章内容引用,站点资源统一位于
content/assets/。
放置约束
- 新文章放入对应年份目录;文件路径会参与生成
/post/{year}/{slug}/的 URL,因此发布后不要随意移动或重命名。 - 保持 frontmatter 至少包含
title、date、tags与published;description用于列表页与 SEO 摘要时一并维护。 - 正文资源优先放入
content/assets/并使用稳定的相对引用;不要将构建后的文件放入文章目录。
开发偏好
published: false用于在首页文章查询中隐藏草稿。- 标签会由
gatsby-node.ts聚合并生成标签页,使用已有标签命名以避免近义标签分裂。 - 文章含数学公式、代码块或嵌入内容时,使用现有 Remark 插件支持的标准 Markdown 语法。

