资源
Syntax
PAGE.Resources
Returns
resource.Resources
Resources
方法返回一个页面资源集合,它是页面束(page bundle)中的文件。
要使用全局或远程资源,请查看 resources
函数。
方法
- ByType
- (
resource.Resources
) 返回给定媒体类型(media type)的页面资源集合,如果没有找到则返回 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 pattern)匹配的第一个页面资源,如果没有找到则返回 nil。
{{ with .Resources.GetMatch "images/*.jpg" }}
<img src="{{ .RelPermalink }}" width="{{ .Width }}" height="{{ .Height }}" alt="">
{{ end }}
如果要处理全局资源而不是页面资源,请使用 resources.GetMatch
函数。
- Match
- (
resource.Resources
) 返回与给定通配符模式(glob pattern)匹配的页面资源集合,如果没有找到则返回 nil。
{{ range .Resources.Match "images/*.jpg" }}
<img src="{{ .RelPermalink }}" width="{{ .Width }}" height="{{ .Height }}" alt="">
{{ end }}
如果要处理全局资源而不是页面资源,请使用 resources.Match
函数。
模式匹配
Hugo 使用不区分大小写的通配符模式(glob pattern)来判断 GetMatch
和 Match
方法的匹配情况。
路径 | 模式 | 匹配 |
---|---|---|
images/foo/a.jpg |
images/foo/*.jpg |
是 |
images/foo/a.jpg |
images/foo/*.* |
是 |
images/foo/a.jpg |
images/foo/* |
是 |
images/foo/a.jpg |
images/*/*.jpg |
是 |
images/foo/a.jpg |
images/*/*.* |
是 |
images/foo/a.jpg |
images/*/* |
是 |
images/foo/a.jpg |
*/*/*.jpg |
是 |
images/foo/a.jpg |
*/*/*.* |
是 |
images/foo/a.jpg |
*/*/* |
是 |
images/foo/a.jpg |
**/*.jpg |
是 |
images/foo/a.jpg |
**/*.* |
是 |
images/foo/a.jpg |
**/* |
是 |
images/foo/a.jpg |
** |
是 |
images/foo/a.jpg |
*/*.jpg |
否 |
images/foo/a.jpg |
*.jpg |
否 |
images/foo/a.jpg |
*.* |
否 |
images/foo/a.jpg |
* |
否 |