Hugo：不修改主题代码，如何为主题布局的head块添加内容

针对单类页面（比如列表页）扩展 #

如果只想给列表页的head添加自定义内容，不用完全覆盖主题的列表布局，按以下步骤操作：

• 在项目根目录新建路径 layouts/_default/list.html
• 先引入主题原有的列表布局，再定义head块插入自定义内容，示例代码：

{{ define "head" }}
  <!-- 这里放置你的自定义HTML内容，比如额外的meta标签、样式或脚本 -->
  <meta name="custom-description" content="我的自定义页面描述">
  <link rel="stylesheet" href="/css/custom-style.css">
{{ end }}

{{ partial "theme/_default/list.html" . }}

这种方式既保留了主题原列表页的完整布局，又成功给head块添加了自定义内容。

全局所有页面扩展head块 #

如果想给所有页面统一添加自定义head内容，更高效的方式：

1. 在项目中新建文件 layouts/partials/head-custom.html，将需要添加的自定义HTML内容写入其中
2. 把主题的baseof.html文件复制到项目的layouts/目录下（不要修改主题内的原文件），然后修改其中的head块：

{{- block "head" . }}
  {{ partial "head-custom.html" . }}
{{ end }}

这样所有继承该baseof模板的页面，都会自动加载你的自定义head内容，完全不影响主题原有逻辑。

核心原理 #

Hugo的模板支持局部块覆盖：通过define重写head块后，用theme/前缀引用主题原布局的partial文件，就能保留主题原有布局的全部内容，仅替换你需要修改的head部分，无需整体覆盖整个布局文件。

内容的提问来源于stack exchange，提问作者Octetz