safe.HTML

January 1, 1

介紹

Hugo 使用 Go 的 text/template 和 html/template 套件。

text/template 套件實現了資料驅動的範本，用於生成文字輸出；而 html/template 套件則實現了資料驅動的範本，用於生成安全防範程式碼注入的 HTML 輸出。

預設情況下，Hugo 在渲染 HTML 檔案時會使用 html/template 套件。

為了生成避免程式碼注入的安全 HTML 輸出，html/template 套件會在特定情境下對字串進行轉譯。

使用 safe.HTML 函式來封裝已知安全的 HTML 文件片段。不應用於來自第三方的 HTML，或包含未關閉的標籤或註解的 HTML。

使用此類型會存在安全風險：封裝的內容應來自可信來源，因為它將在範本輸出中原文包含。

詳情請參閱 Go 文件。

未宣告為安全的情況下：

{{ $html := "<em>emphasized</em>" }}
{{ $html }}

Hugo 渲染後為：

&lt;em&gt;emphasized&lt;/em&gt;

要將字串宣告為安全：

{{ $html := "<em>emphasized</em>" }}
{{ $html | safeHTML }}

Hugo 渲染後為：

<em>emphasized</em>