safe.URL

safe.URL INPUT

template.URL

safeURL

简介

Hugo 使用 Go 的 text/template 和 html/template 包。

text/template 包实现了用于生成文本输出的数据驱动模板，而 html/template 包实现了用于生成可防止代码注入的 HTML 输出的数据驱动模板。

默认情况下，Hugo 在渲染 HTML 文件时使用 html/template 包。

为了生成可防止代码注入的 HTML 输出，html/template 包会在某些上下文中转义字符串。

用法

使用 safe.URL 函数来封装已知的安全 URL 或 URL 子字符串。除了以下方案之外的其他方案都被认为是不安全的

• http
• https
• mailto

使用此类型存在安全风险：封装的内容应来自可信来源，因为它将原封不动地包含在模板输出中。

有关详细信息，请参阅 Go 文档。

示例

没有安全声明

{{ $href := "irc://irc.freenode.net/#golang" }}
<a href="{{ $href }}">IRC</a>

Hugo 将以上内容渲染为

<a href="#ZgotmplZ">IRC</a>

要将字符串声明为安全

{{ $href := "irc://irc.freenode.net/#golang" }}
<a href="{{ $href | safeURL }}">IRC</a>

Hugo 将以上内容渲染为

<a href="irc://irc.freenode.net/#golang">IRC</a>