模板函数与类型转换
在 Hugo 中，函数是在模板动作中使用的代码片段，它们接收一个或多个参数并返回一个值。与方法不同，函数不与特定的对象关联。它们用于将内容、资源和数据转换为发布的页面。Hugo 作为一个用 Go 语言编写的静态站点生成器，其函数体系充分利用了 Go 语言的特性，提供了高性能和丰富的功能。
函数的定义与目的
函数是 Hugo 强大且灵活的内容处理和模板渲染能力的基石。它们允许用户在模板中执行各种操作，从基本的数据转换到复杂的资源处理和站点逻辑控制。
函数的类型
Hugo 提供了两种主要类型的函数：
Go 语言内置函数
Hugo 使用 Go 语言的 text/template 和 html/template 包来渲染模板。这些包提供了一小部分用于通用目的的函数、运算符和语句。
例如：and、block、break、continue、define、else、end、if、len、not、or、range、return、template、try、urlquery 和 with 等。
Hugo 自定义函数
Hugo 提供了数百个自定义函数，它们根据功能被命名空间分类。这些函数极大地扩展了 Hugo 的能力，涵盖了从字符串操作、日期处理到文件系统访问、图像处理等各种高级功能。许多常用函数还提供了别名以简化代码长度。
函数的使用方式
模板动作
函数在模板动作中使用，模板动作由 {{ 和 }} 这样的花括号对表示。
参数传递
调用函数时，参数与函数之间、以及参数之间都用空格分隔。
{{ functionName param1 param2 }}
管道（Pipes）
在模板动作中，可以通过管道将一个值传递给函数或方法，被管道传递的值将成为函数或方法的最后一个参数，这种链式操作提高了代码的简洁性和可读性。
{{ "hello world" | upper }}
{{ .Content | markdownify }}
重要的函数类别与功能示例
Hugo 的自定义函数库非常庞大，涵盖了网站构建的各个方面：
内容转换与格式化
transform.Markdownify：将 Markdown 渲染为 HTMLtransform.Highlight：使用 Chroma 语法高亮器高亮代码transform.Emojify：处理字符串中的 Emoji 表情符号短代码transform.Plainify：移除 HTML 标签，返回纯文本transform.ToMath：渲染 LaTeX 语法的数学公式transform.Unmarshal：解析序列化数据（如 CSV, JSON, TOML, YAML, XML）并返回映射或数组transform.Remarshal：将序列化数据或映射重新编组为指定格式的序列化数据safe.HTML、safe.CSS、safe.JS、safe.URL等：将给定字符串声明为安全的 HTML、CSS、JavaScript 或 URL，防止代码注入风险
数据操作与集合处理
collections.Where：根据条件过滤页面集合或映射切片collections.Sort：对切片或映射进行排序collections.First、collections.Last：返回集合的前 N 个或后 N 个元素collections.Append、collections.Merge：用于合并或追加集合collections.Querify：将键值对转换为 URL 查询字符串collections.IsSet：报告键是否存在于集合中，即使其值为假collections.NewScratch（已弃用，建议使用Page.Store或SHORTCODE.Store）：创建用于存储和操作数据的"临时存储空间"
文件与资源处理（Hugo Pipes）
resources.Get、resources.GetMatch、resources.Match：用于获取和匹配全局或页面资源resources.GetRemote：获取远程资源resources.Minify：缩小 HTML, CSS, JS, JSON, SVG, XML 资源以减小文件大小resources.Concat：将多个资产捆绑到一个资源中css.Sass、css.PostCSS、js.Build：用于处理 Sass、PostCSS 和 JavaScript 资产images.QR：将文本编码为 QR 码并返回图像资源images.Process：对图像应用一个或多个处理过滤器
时间与日期
time.Now：返回当前本地时间time.Format：格式化time.Time值time.AsTime：将字符串表示的日期/时间值转换为time.Time值
站点与页面信息
page（全局函数）：在模板中的任何位置访问当前的Page对象。需要注意的是，在短代码或由短代码调用的局部模板中，若要访问其调用页面的Page对象，应避免直接使用page函数，因为它会访问顶级模板传入的Page对象，可能导致缓存不一致或意外结果site（全局函数）：提供对当前Site对象的全局访问hugo.Version、hugo.IsProduction、hugo.Environment等：返回 Hugo 版本、当前环境等信息hugo.Store：返回一个全局作用域的"临时存储空间"（scratch pad），用于存储和操作数据
函数与上下文（Context）
理解上下文对于编写模板至关重要。在 Hugo 模板中，**点（.）**表示当前的上下文，它可以是简单值，也可以是 Page 对象等。当上下文在 range 或 with 等代码块内改变时，**美元符号（$）**允许你始终访问传入顶级模板的原始上下文（通常是 Page 对象）。这是避免常见模板错误的关键。
{{ range .Pages }}
<h2>{{ .Title }}</h2>
<p>站点标题：{{ $.Site.Title }}</p>
{{ end }}
函数与 Shortcodes 的关系
函数在 Shortcodes 的实现中扮演着核心角色。Shortcodes 允许内容作者在 Markdown 中嵌入复杂元素，而无需直接编写 HTML 或 Go Template 逻辑。自定义 Shortcode 的模板就是 Go Template，其中会大量使用 Hugo 的内置函数来处理 Shortcode 的参数（SHORTCODE.Params）、内部内容（SHORTCODE.Inner）、以及访问当前页面的数据（SHORTCODE.Page）。
例如，qr Shortcode 内部调用了 images.QR 函数来生成二维码图像。
函数与安全性
Hugo 的安全模型基于"信任模板和配置作者，但不信任内容作者"的原则。因此，像 safe.HTML 这样的函数用于明确标记安全内容，以防止代码注入。
此外，像 os.Getenv 和 resources.GetRemote 这样的函数，为了运行时安全，其对环境变量和远程 URL 的访问受到严格的白名单控制，默认情况下是受限的，需要通过站点配置来允许特定访问。
函数与调试/性能
调试
debug.Dump函数可以返回对象的完整转储字符串，用于调试fmt.Warnf和fmt.Errorf可以在构建过程中打印警告和错误消息，帮助识别问题
性能
debug.Timer函数可以用来测量代码块的执行时间，帮助识别模板中的性能瓶颈partialCached函数提供了缓存能力，对于在站点构建过程中多次执行的局部模板，可以显著提高性能resources.GetRemote的结果也会被缓存到磁盘，提高后续访问速度
总结
Hugo 中的函数是实现其"速度快，设计灵活"核心理念的关键工具。它们提供了一个丰富而强大的 API，使开发者能够细粒度地控制网站的各个方面，从内容渲染到资产优化，同时兼顾性能和安全性。熟练运用这些函数是充分发挥 Hugo 优势，构建高效、功能丰富的静态网站的基础。
函数与方法的区别
Hugo 模板系统中有两个重要概念：函数和方法。
- 函数：不与特定对象关联的代码片段，接收参数并返回值
- 方法：与特定对象关联的操作，通过对象调用
关于方法的详细信息，请参见模板方法章节。