反射函数 on Hugo 中文文档

reflect.IsImageResource

Fri, 02 Oct 2026 00:00:00 +0800

（0.154.0 新增）

用法

下例遍历项目的全部资源，用 reflect.IsImageResource 决定是渲染 img 标签，还是为非图像文件给出下载链接。

{{ range resources.Match "**" }}
  {{ if reflect.IsImageResource . }}
    <img src="{{ .RelPermalink }}" alt="Image">
  {{ else }}
    <a href="{{ .RelPermalink }}">Download</a>
  {{ end }}
{{ end }}

图像操作

用这些函数判断 Hugo 对给定资源支持哪些操作。Hugo 会把多种文件类型都归类为图像资源，但能否处理它们、能否提取元数据，则取决于具体格式。

reflect.IsImageResourceProcessable

Fri, 02 Oct 2026 00:00:00 +0800

（0.157.0 新增）

可处理的图像（processable image）

用法

下例遍历项目的全部资源，用 reflect.IsImageResourceProcessable 确保在开始处理之前，图像管道确实能执行缩放等变换。

reflect.IsImageResourceWithMeta

Fri, 02 Oct 2026 00:00:00 +0800

（0.157.0 新增）

用法

下例遍历项目的全部资源，用 reflect.IsImageResourceWithMeta 只为受支持的格式显示图像尺寸与元数据。

{{ range resources.Match "**" }}
  {{ if reflect.IsImageResourceWithMeta . }}
    <img src="{{ .RelPermalink }}" width="{{ .Width }}" height="{{ .Height }}" alt="Image with Meta">
    {{ with .Meta }}
      <p>Taken on: {{ .Date }}</p>
    {{ end }}
  {{ end }}
{{ end }}

图像操作

用这些函数判断 Hugo 对给定资源支持哪些操作。Hugo 会把多种文件类型都归类为图像资源，但能否处理它们、能否提取元数据，则取决于具体格式。

reflect.IsMap

Fri, 02 Oct 2026 00:00:00 +0800

{{ reflect.IsMap (dict "key" "value") }} → true
{{ reflect.IsMap "yo" }} → false

reflect.IsPage

Fri, 02 Oct 2026 00:00:00 +0800

（0.154.0 新增）

layouts/page.html

{{ with site.GetPage "/examples" }}
  {{ reflect.IsPage . }} → true
{{ end }}

{{ with .Site  }}
  {{ reflect.IsPage . }} → false
{{ end }}

reflect.IsResource

Fri, 02 Oct 2026 00:00:00 +0800

（0.154.0 新增）

项目结构如下：

project/
├── assets/
│   ├── a.json
│   ├── b.avif
│   └── c.jpg
└── content/
    └── example/
        ├── index.md
        ├── d.json
        ├── e.avif
        └── f.jpg

下例给出 reflect.IsResource 函数返回的值：

reflect.IsSite

Fri, 02 Oct 2026 00:00:00 +0800

（0.154.0 新增）

layouts/page.html

{{ with .Site  }}
  {{ reflect.IsSite . }} → true
{{ end }}

{{ with site.GetPage "/examples" }}
  {{ reflect.IsSite . }} → false
{{ end }}

reflect.IsSlice

Fri, 02 Oct 2026 00:00:00 +0800

{{ reflect.IsSlice (slice 1 2 3) }} → true
{{ reflect.IsSlice "yo" }} → false