术语表

参数(parameter)

通常指站点或页面级的用户自定义键值对,也可指配置项或实参。

难度
参考

开始之前,你需要

  • 在文档里遇到不认识的 Hugo 术语时查阅

读完之后你能

  • 分清站点参数与页面参数该写在哪、该用哪个方法读取,并在取到空值时知道先查什么

接着读:参数配置

参数(parameter)通常指站点级或页面级的用户自定义键值对,但也可以指某个配置设置或一个 argument。

为什么重要

站点参数写在项目配置的 [params] 下、用 site.Params 读,页面参数写在该页的前置元数据里、用 .Params 读;两套来源不同,写错位置时模板取到的是空值,而且不会报错。 另一个常见混淆是 .Param 与 .Params:前者在页面没写时会回退到站点参数,后者只读页面自己的前置元数据,选哪个取决于你希望「页面没写时」发生什么。 取不到值时先用 hugo config 看生效的配置,确认键名没写错、层级([params.contact] 与 [params] contact.email)符合预期。

延伸阅读:参数配置 · Params 方法