术语表 前置元数据(front matter) 每个内容页面开头的元数据,与正文之间用格式相关的定界符分隔。 难度参考 开始之前,你需要 在文档里遇到不认识的 Hugo 术语时查阅 读完之后你能 能写出一段不会解析失败的前置元数据,并在报错指向文件首行时判断问题出在哪里 接着读:前置元数据 前置元数据(front matter)指每个内容页面开头的元数据,它与正文之间用与格式对应的定界符分隔。 为什么重要 前置元数据是「页面能不能被正确识别」的第一道关:定界符用错(YAML 的 ---、TOML 的 +++、JSON 的花括号混用),或值里出现冒号、井号等未加引号的字符,Hugo 会直接报解析错误并指向文件开头附近,整个构建中断。另一种不报错的情况是字段名拼错:值写进了 .Params 却没人用,表现为标题、日期、排序「改了不生效」,所以排查时先确认定界符与字段名,再怀疑模板。 延伸阅读:前置元数据、内容格式 参见:前置元数据 ← 上一篇:片段 下一篇:函数 →