内容目录和写作约定看起来像内部规则,但它们直接决定后续写作效率、搜索质量和自动化稳定性。站点越早把这些约定固定下来,后面扩展起来就越省力。

先把内容放到正确的位置

  • content/posts 放正式文章。
  • content/bulletins 放公告详情内容。
  • 根目录的单页内容负责关于、链接、联系、搜索等固定页面。

哪些字段最值得先写好

  • title 用来确定页面标题。
  • date 必须写成已经过去的时间,避免 Hugo 因未来时间而跳过渲染。
  • description 优先补齐,便于列表页和搜索结果页展示摘要。
  • categoriestags 用来串起主题导航。

哪些页面不应该进入搜索

像联系页、归档页、搜索页、链接页这类工具页,应该通过 searchExclude 排除出全文搜索结果,避免搜索结果里混入过多功能型页面。

为什么这些约定值得尽早固定

因为后续一旦接 GitHub Actions 自动生成内容,脚本也要遵守同一套目录和 front matter 约定,不然内容质量和结构一致性都会很快失控。