Page

Resources

返回页面资源集合。

签名
PAGE.Resources
返回类型
resource.Resources

Page 对象上的 Resources 方法返回页面资源的集合。页面资源是页面包中的文件。

要处理全局资源或远程资源,请参见 resources 函数。

方法

在 Resources 对象上使用这些方法。

ByType
(resource.Resources)返回给定媒体类型的页面资源集合;如果没有找到则返回 nil。媒体类型通常是 image、text、audio、video 或 application 之一。
{{ range .Resources.ByType "image" }}
  <img src="{{ .RelPermalink }}" width="{{ .Width }}" height="{{ .Height }}" alt="">
{{ end }}

如果处理的是全局资源而不是页面资源,请使用 resources.ByType 函数。

Get
(resource.Resource)返回给定路径的页面资源;如果没有找到则返回 nil。
{{ with .Resources.Get "images/a.jpg" }}
  <img src="{{ .RelPermalink }}" width="{{ .Width }}" height="{{ .Height }}" alt="">
{{ end }}

如果处理的是全局资源而不是页面资源,请使用 resources.Get 函数。

GetMatch
(resource.Resource)返回路径匹配给定 glob 模式的第一个页面资源;如果没有找到则返回 nil。
{{ with .Resources.GetMatch "images/*.jpg" }}
  <img src="{{ .RelPermalink }}" width="{{ .Width }}" height="{{ .Height }}" alt="">
{{ end }}

如果处理的是全局资源而不是页面资源,请使用 resources.GetMatch 函数。

Match
(resource.Resources)返回路径匹配给定 glob 模式的页面资源集合;如果没有找到则返回 nil。
{{ range .Resources.Match "images/*.jpg" }}
  <img src="{{ .RelPermalink }}" width="{{ .Width }}" height="{{ .Height }}" alt="">
{{ end }}

如果处理的是全局资源而不是页面资源,请使用 resources.Match 函数。

Mount
(0.140.0 新增)
(resource.ResourceGetter)挂载给定的资源,把基础路径(第一个参数)重映射到目标路径(第二个参数),并返回一个资源获取器。目标路径中的前导斜杠表示绝对路径。相对目标路径让你可以相对另一组资源(例如页面包)来挂载资源:
{{ $common := resources.Match "/js/headlessui/*.*" }}
{{ $importContext := (slice $.Page ($common.Mount "/js/headlessui" ".")) }}

模式匹配

使用 GetMatch 和 Match 方法时,Hugo 会按不区分大小写的 glob 模式来判断是否匹配。语法规则和示例请参见 [glob 模式速查指南][]。