Content
返回给定资源的内容。
这一页解决什么问题
资源不只是「一个 URL」:assets/ 里的 CSS、JS、文本、图片,乃至页面包里写成 .md 的片段,内容本身经常要嵌进当前页面,而不是让浏览器再发一次请求。Content 就是「把资源当字符串读出来」的入口——读出原始字节,交给 len、base64Encode、safeCSS、safeJS 之类的函数继续处理。
资源类型为 page 时,Resource 对象上的 Content 方法返回 template.HTML,否则返回 string。
什么时候用,什么时候别用
该用:
- 把关键 CSS / JS 内联进 HTML,减少一次阻塞请求;
- 把很小的图片转成 data URI(
base64Encode)嵌进页面; - 统计文本资源的字节数(
{{ .Content | len }},不是字符数); - 读取页面包里
_xxx.md这类页面资源的正文,拼进当前页(此时返回template.HTML,会按 HTML 处理)。
别用:
- 只是想让浏览器单独请求该资源 → 用
RelPermalink或Permalink; - 资源是图片且需要缩放/裁剪/转格式 → 用
Resize、Process等;Content拿到的永远是原图字节; - 想把 YAML/JSON/TOML 资源解析成数据结构 → 用
transform.Unmarshal(可以先把resources.Get的结果交给它); - 想在模板里拼字符串 → 直接用
printf,没必要借资源绕一圈。
用法
上游示例假设 assets/quotations/kipling.txt 的内容是:
assets/quotations/kipling.txt
He travels the fastest who travels alone.要取得内容:
go-html-template
{{ with resources.Get "quotations/kipling.txt" }}
{{ .Content }} → He travels the fastest who travels alone.
{{ end }}要取得以字节为单位的大小:
go-html-template
{{ with resources.Get "quotations/kipling.txt" }}
{{ .Content | len }} → 42
{{ end }}要创建内联图像:
go-html-template
{{ with resources.Get "images/a.jpg" }}
<img src="data:{{ .MediaType.Type }};base64,{{ .Content | base64Encode }}">
{{ end }}要创建内联 CSS:
go-html-template
{{ with resources.Get "css/style.css" }}
<style>{{ .Content | safeCSS }}</style>
{{ end }}要创建内联 JavaScript:
go-html-template
{{ with resources.Get "js/script.js" }}
<script>{{ .Content | safeJS }}</script>
{{ end }}完整示例(实测)
测量条件:Hugo 0.167.0 extended,Windows,最小站点。assets/css/style.css 内容为 body { color: #222; } 加一个换行;assets/js/script.js 内容为 console.log('hello'); 加一个换行;assets/quotations/kipling.txt 共 42 字节(含结尾换行)。把下面这段放进 layouts/_default/single.html:
layouts/_default/single.htmlgo-html-template
{{ with resources.Get "css/style.css" }}
<style>{{ .Content | safeCSS }}</style>
{{ end }}
{{ with resources.Get "js/script.js" }}
<script>{{ .Content | safeJS }}</script>
{{ end }}
{{ with resources.Get "quotations/kipling.txt" }}
<p>字节数:{{ .Content | len }}</p>
{{ end }}Hugo 渲染为(资源自带的结尾换行会原样输出,模板换行产生的空行此处省略):
html
<style>body { color: #222; }
</style>
<script>console.log('hello');
</script>
<p>字节数:42</p>你应当看到什么:<script> 里的引号没有被转义成 ',因为 safeJS 告诉 Hugo「这段内容已经是安全的 JS」;不写 safeJS 时引号会被转义,内联脚本就会坏掉。同理,内联 CSS 必须经过 safeCSS。
返回值边界(实测)
| 情况 | 结果 | 是否报错 |
|---|---|---|
文本资源(text/plain) |
string,原样字节 |
否 |
| 图像资源 | string,二进制内容(可 base64Encode) |
否 |
| CSS / JS 资源 | string |
否 |
页面资源(资源类型 为 page) |
template.HTML |
否 |
| 空文件 | 空字符串,len 为 0 |
否 |
resources.Get 找不到文件(资源为 nil) |
—— | 是:nil pointer evaluating resource.Resource.Content |
| 远程资源 | 同全局资源;但需要联网,本站未实测 | —— |
常见坑
| 类别 | 症状 | 真因 | 怎么修 |
|---|---|---|---|
| 没报错但结果不对 | 内联的 JS 在浏览器里报语法错误 | 没经 safeJS,引号被转义成 ' |
`{{ .Content |
| 没报错但结果不对 | 内联 CSS 多了 " 之类实体 |
没经 safeCSS |
`{{ .Content |
| 没报错但结果不对 | 页面包里 _xxx.md 的内容被当成纯文本 |
那是 template.HTML,直接 {{ .Content }} 即可;不要再用 markdownify |
去掉多余的 markdownify |
| 报错看不懂 | nil pointer evaluating resource.Resource.Content |
resources.Get 没找到文件 |
用 {{ with resources.Get "…" }} 包住,或纠正路径大小写 |
| 报错看不懂 | error calling GetRemote: … |
远程资源需要网络,且受 security.http 白名单限制 |
用 try 包住并读 .Err |
更多排查入口见故障排查。