文档章节

函数

在模板与原型中使用的全部函数与方法。

本章导读

模板的能力来自函数(function)与方法(method)。本目录按包(package)分组收录 Hugo 内建的全部函数,例如 collections、strings、transform、urls;函数名与参数、返回值都保持英文原样,不译。

调用函数通常有两种写法:直接嵌套 {{ sub 3 2 }},或用管道 {{ 3 | sub 2 }}。管道把左侧的结果作为右侧函数的最后一个参数传入,读起来更接近数据流动的顺序。

同名函数与方法的差别,以及命名空间(如 hugo.、site.、strings.)的含义,分别见方法一章与各页说明。

本章内容

  • 类型转换函数 使用这些函数把值从一种数据类型转换为另一种。 (今天)
  • 集合函数 用这些函数操作与查询映射(map)、切片(slice)和字符串。 (今天)
  • 比较函数 使用这些函数比较两个或多个值。 (今天)
  • 加密函数 用这些函数生成加密哈希。 (今天)
  • CSS 函数 用这些函数处理 CSS 与 Sass 文件。 (今天)
  • 调试函数 使用这些函数调试你的模板。 (今天)
  • 图表函数 用这些函数渲染图表。 (今天)
  • 编码函数 用这些函数对数据做编码与解码。 (今天)
  • 格式化输出函数 使用这些函数在模板中输出字符串,或向终端输出消息。 (今天)
  • 全局函数 使用这些全局函数访问页面与站点数据。 (今天)
  • Go 模板函数与语句 用这些函数与语句编写条件判断、循环及其它模板逻辑。 (今天)
  • 哈希函数 用这些函数生成非加密哈希。 (今天)
  • Hugo 函数 用这些函数获取 Hugo 应用程序与当前运行环境的信息。 (今天)
  • 图像函数 用这些函数创建图像滤镜、把图像滤镜应用到图像上,以及读取图像信息。 (今天)
  • 词形变化函数 使用这些函数做词形变化,例如英语名词的单数化与复数化。 (今天)
  • JavaScript 函数 用这些函数处理 JavaScript 与 TypeScript 文件。 (今天)
  • 语言函数 使用这些函数让站点满足语言与地区方面的要求。 (今天)
  • 数学函数 使用这些函数执行数学运算。 (今天)
  • OpenAPI 函数 用这些函数处理 OpenAPI 3 定义。 (今天)
  • 操作系统函数 使用这些函数与操作系统交互。 (今天)
  • 局部模板函数 使用这些函数调用局部模板(partial)。 (今天)
  • 路径函数 用这些函数处理文件路径。 (今天)
  • 反射函数 用这些函数判断一个值的数据类型。 (今天)
  • 资源函数 用这些函数处理资源。 (今天)
  • 安全函数 使用这些函数在 Go 的 html/template 包的上下文中把值声明为安全。 (今天)
  • 字符串函数 用这些函数处理字符串。 (今天)
  • 模板函数 用这些函数查询模板系统。 (今天)
  • 时间函数 使用这些函数处理时间值。 (今天)
  • 转换函数 用这些函数把取值从一种格式转换为另一种格式。 (今天)
  • URL 函数 用这些函数处理 URL。 (今天)