1 分钟阅读

博客文章目录

这个目录负责什么

  • 按年份保存 Gatsby 处理的文章 Markdown 源文件。
  • 相对图片与附件资源由文章内容引用,站点资源统一位于 content/assets/

放置约束

  • 新文章放入对应年份目录;文件路径会参与生成 /post/{year}/{slug}/ 的 URL,因此发布后不要随意移动或重命名。
  • 保持 frontmatter 至少包含 titledatetagspublisheddescription 用于列表页与 SEO 摘要时一并维护。
  • 正文资源优先放入 content/assets/ 并使用稳定的相对引用;不要将构建后的文件放入文章目录。

开发偏好

  • published: false 用于在首页文章查询中隐藏草稿。
  • 标签会由 gatsby-node.ts 聚合并生成标签页,使用已有标签命名以避免近义标签分裂。
  • 文章含数学公式、代码块或嵌入内容时,使用现有 Remark 插件支持的标准 Markdown 语法。

37 字 · 12 段落
xi ming

Written by xi ming You should follow him on Github

评论与讨论