HUGO 中文文档

  • 新闻
  • 文档
  • 主题
  • 社区
  • GitHub
gohugoio Star
  • 关于
    • 本节内容
    • 简介
    • 特性
    • 隐私
    • 安全
    • 许可证
  • 安装
    • 本节内容
    • macOS
    • Linux
    • Windows
    • BSD
  • 快速上手
    • 本节内容
    • 快速入门
    • 基本用法
    • 目录结构
    • 配置
    • 配置标记
    • 术语表
    • 配置构建
    • 外部学习资源
  • 快速参考
    • 本节内容
    • 表情符号
    • 函数
    • 方法
    • 页面集合
  • 内容管理
    • 本节内容
    • 组织
    • 页面包
    • 内容格式
    • Front matter (前置 matter)
    • 构建选项
    • 页面资源
    • 图片处理
    • 短代码
    • 相关内容
    • 章节
    • 内容类型
    • 原型
    • 分类法
    • 摘要
    • 链接和交叉引用
    • URL 管理
    • 菜单
    • 评论
    • 多语言
    • Markdown 属性
    • 语法高亮
    • 图表
    • 数学公式
    • 数据源
    • 内容适配器
  • 模板
    • 本节内容
    • 简介
    • 模板类型
    • 查找顺序
    • 基模板
    • 首页模板
    • 单个模板
    • 章节模板
    • 分类模板
    • 术语模板
    • 局部模板
    • 内容视图模板
    • 短代码模板
    • 站点地图模板
    • RSS 模板
    • 404 模板
    • robots.txt 模板
    • 菜单
    • 分页
    • 内嵌模板
    • 自定义输出格式
  • 函数
    • 本节内容
    • css
    • fmt
    • go 模板
    • hugo
    • js
    • lang
    • openapi3
    • os
    • urls
    • 全局
    • 加密
    • 反射
    • 变形
    • 变换
    • 哈希
    • 图像
    • 图表函数
    • 字符串
    • 安全函数
    • 局部模板函数
    • 数学
    • 数据
    • 时间
    • 模板
    • 比较
    • 类型转换
    • 编码
    • 调试
    • 资源
    • 路径
    • 集合
  • 方法
    • 本节内容
    • Duration
    • Menu
    • Page
    • Pager
    • Resource
    • Shortcode
    • Site
    • Taxonomy
    • Time
    • 菜单项
    • 页面
  • 渲染钩子
    • 本节内容
    • 简介
    • 块引用
    • 代码块
    • 标题
    • Images
    • 链接
    • Passthrough
    • 表格
  • Hugo 模块
    • 本节内容
    • 配置 Hugo 模块
    • 使用 Hugo 模块
    • 主题组件
  • Hugo 管道
    • 本节内容
    • 简介
    • 将 Sass 编译为 CSS
    • PostCSS
    • PostProcess
    • JavaScript 构建
    • 资源压缩
    • 连接资产
    • 指纹和 SRI 哈希
    • 从字符串创建资源
    • 从模板创建资源
  • 命令行界面
  • 故障排除
    • 本节内容
    • Audit
    • 日志记录
    • 检查
    • 弃用
    • 性能
    • FAQs
  • 开发者工具
    • 本节内容
    • 编辑器插件
    • 前端
    • Search
    • 迁移
    • 其他项目
  • 托管和部署
    • 本节内容
    • Hugo 部署
    • 使用 Rclone 部署
    • 使用 Rsync 部署
    • 在 21YunBox 上托管
    • 在 AWS Amplify 上托管
    • 在 Cloudflare Pages 上托管
    • 在 Firebase 上托管
    • 在 GitLab Pages 上托管
    • 在 Netlify 上托管
    • 在 Render 上托管
    • 托管在 Azure 静态 Web 应用上
    • 托管在 GitHub Pages 上
    • 托管在 KeyCDN 上
  • 贡献
    • 本节内容
    • 开发
    • 文档
    • 主题
  • 维护
QUICK REFERENCE

函数

Hugo 函数的快速参考指南,按命名空间分组。别名(如有)显示在函数名称右侧括号中。

css

使用这些函数处理 CSS 和 Sass 文件。

css.PostCSS (postCSS)
使用任何 PostCSS 插件使用 PostCSS 处理给定的资源。
css.Sass (toCSS)
将 Sass 转换为 CSS。
css.TailwindCSS
使用 Tailwind CSS CLI 处理给定的资源。

fmt

使用这些函数在模板中打印字符串或向终端打印消息。

fmt.Errorf (errorf)
从模板记录 ERROR 日志。
fmt.Erroridf (erroridf)
从模板记录可抑制的 ERROR。
fmt.Print (print)
使用标准 fmt.Print 函数打印给定参数的默认表示形式。
fmt.Printf (printf)
使用标准 fmt.Sprintf 函数格式化字符串。
fmt.Println (println)
使用标准 fmt.Print 函数打印给定参数的默认表示形式,并强制换行。
fmt.Warnf (warnf)
从模板中记录 WARNING 日志。
fmt.Warnidf (warnidf)
从模板记录可抑制的 WARNING。

go 模板

这些是 Go 的 text/template 包提供的函数、运算符和语句。

and
返回第一个假值参数。如果所有参数都为真值,则返回最后一个参数。
block
定义一个模板并在适当位置执行它。
break
用于 range 语句,停止最内层迭代并跳过所有剩余迭代。
continue
与 range 语句一起使用,停止最内层迭代并继续下一个迭代。
define
定义一个模板。
else
为 if、with 和 range 语句开始一个备选代码块。
end
终止 if、with、range、block 和 define 语句。
if
如果表达式为真,则执行代码块。
len
返回字符串、切片、映射或集合的长度。
not
返回其单个参数的布尔反值。
or
返回第一个真值参数。如果所有参数都为假值,则返回最后一个参数。
range
迭代非空集合,将上下文(点)绑定到连续的元素,并执行代码块。
return
在局部模板中使用,终止模板执行并返回给定的值(如果有)。
template
执行给定的模板,可以选择性地传递上下文。
urlquery
返回其参数文本表示的转义值,该值适合嵌入 URL 查询中。
with
将上下文(点)绑定到表达式,如果表达式为真,则执行块。

hugo

使用这些函数访问有关 Hugo 应用程序和当前环境的信息。

hugo.BuildDate
返回 Hugo 二进制文件的编译日期。
hugo.CommitHash
返回 Hugo 二进制文件的 Git 提交哈希值。
hugo.Deps
返回项目依赖项的切片,可以是 Hugo 模块或本地主题组件。
hugo.Environment
返回当前运行的环境。
hugo.Generator
渲染一个 HTML 元元素,用于识别生成站点的软件。
hugo.GoVersion
返回用于编译 Hugo 二进制文件的 Go 版本
hugo.IsDevelopment
报告当前运行环境是否为“开发”环境。
hugo.IsExtended
报告 Hugo 二进制文件是否为扩展版本。
hugo.IsMultihost
报告每个已配置语言是否具有唯一的基准 URL。
hugo.IsMultilingual
报告是否配置了两种或多种语言。
hugo.IsProduction
报告当前运行环境是否为“生产”环境。
hugo.IsServer
报告内置开发服务器是否正在运行。
hugo.Store
返回一个全局的、持久的“备忘录”用于存储和操作数据。
hugo.Version
返回当前 Hugo 二进制文件的版本。
hugo.WorkingDir
返回项目工作目录。

js

使用这些函数来处理 JavaScript 和 TypeScript 文件。

js.Build
打包、转译、树状摇动和压缩 JavaScript 资源。
js.Batch
使用全局代码分割和灵活的钩子/运行器设置来构建 JavaScript 包组。
js.Babel (babel or /hugo-pipes/babel/)
使用 Babel 编译给定的 JavaScript 资源。

lang

使用这些函数来调整您的站点以满足语言和地区的要求。

lang.FormatAccounting
返回一个数字的货币表示形式,该形式针对当前语言和区域的会计记法,并指定了货币和精度。
lang.FormatCurrency
返回根据当前语言和区域设置,针对给定货币和精度的数字货币表示形式。
lang.FormatNumber
返回根据当前语言和地区,具有指定精度的数字的数值表示形式。
lang.FormatNumberCustom
使用负数、小数和分组选项,返回具有给定精度的数字的数值表示。
lang.FormatPercent
返回一个数字的百分比表示形式,该表示形式具有当前语言和区域的指定精度。
lang.Merge
合并其他语言中缺失的翻译。
lang.Translate (T or i18n)
使用 i18n 目录中的翻译表翻译字符串。

openapi3

使用这些函数来处理 OpenAPI 3 定义。

openapi3.Unmarshal
将给定的资源反序列化为 OpenAPI 3 文档。

os

使用这些函数与操作系统交互。

os.FileExists (fileExists)
报告文件或目录是否存在。
os.Getenv (getenv)
返回环境变量的值,如果环境变量未设置则返回空字符串。
os.ReadDir (readDir)
返回一个按文件名排序的 FileInfo 结构数组,每个目录条目一个元素。
os.ReadFile (readFile)
返回文件的内容。
os.Stat
返回一个描述文件或目录的 FileInfo 结构。

urls

使用这些函数处理网址。

urls.AbsLangURL (absLangURL)
返回一个绝对 URL,如有,则包含语言前缀。
urls.AbsURL (absURL)
返回一个绝对URL。
urls.Anchorize (anchorize)
返回给定的字符串,已进行净化以用于 HTML id 属性。
urls.JoinPath
将提供的元素连接成一个 URL 字符串,并清除结果中任何 ./ 或 ../ 元素。如果参数列表为空,JoinPath 返回空字符串。
urls.Parse
将 URL 解析为 URL 结构。
urls.Ref (ref)
返回给定路径下页面的绝对永久链接。
urls.RelLangURL (relLangURL)
返回一个相对 URL,如有,则包含语言前缀。
urls.RelRef (relref)
返回给定路径下页面的相对永久链接。
urls.RelURL (relURL)
返回相对 URL。
urls.URLize (urlize)
返回给定的字符串,已进行清理,可用于 URL。

全局

使用这些全局函数访问页面和站点数据。

page
提供对 Page 对象的全局访问。
site
提供对当前 Site 对象的全局访问。

加密

使用这些函数创建加密哈希。

crypto.FNV32a
返回给定字符串的 32 位 FNV(Fowler–Noll–Vo)非加密哈希值。
crypto.HMAC (hmac)
返回一个使用密钥对消息进行签名的加密哈希值。
crypto.MD5 (md5)
对给定的输入进行哈希处理,并将其 MD5 校验和编码为十六进制字符串。
crypto.SHA1 (sha1)
对给定输入进行哈希运算,并返回其 SHA1 校验和(以十六进制字符串编码)。
crypto.SHA256 (sha256)
对给定的输入进行哈希计算,并将其 SHA256 校验和编码为十六进制字符串。

反射

使用这些函数来确定值的类型。

reflect.IsMap
报告给定值是否为映射。
reflect.IsSlice
报告给定值是否为切片。

变形

这些函数提供单词变化功能,例如英语名词的单复数转换。

inflect.Humanize (humanize)
返回输入的“人性化”版本,首字母大写。
inflect.Pluralize (pluralize)
根据一组常见的英语复数化规则将给定的单词变为复数形式。
inflect.Singularize (singularize)
根据一套常见的英语单数化规则将给定的单词变成单数形式。

变换

使用这些函数将值从一种格式转换为另一种格式。

transform.CanHighlight
报告给定的代码语言是否受 Chroma 高亮显示器支持。
transform.Emojify (emojify)
将字符串通过 Emoji 表情符号处理器处理。
transform.Highlight (highlight)
使用语法高亮器渲染代码。
transform.HighlightCodeBlock
突出显示在代码块渲染钩子中接收到的上下文中的代码。
transform.HTMLEscape (htmlEscape)
返回给定的字符串,通过将特殊字符替换为 HTML 实体来转义它们。
transform.HTMLUnescape (htmlUnescape)
返回给定的字符串,将每个 HTML 实体替换为其对应的字符。
transform.Markdownify (markdownify)
将 Markdown 渲染为 HTML。
transform.Plainify (plainify)
返回一个已去除所有 HTML 标签的字符串。
transform.Remarshal
将序列化数据的字符串或映射编组到指定格式的序列化数据字符串中。
transform.ToMath
使用 KaTeX 渲染数学表达式。
transform.Unmarshal (unmarshal)
解析序列化数据并返回映射或数组。支持 CSV、JSON、TOML、YAML 和 XML。
transform.XMLEscape
返回给定的字符串,移除不允许的字符,然后将其转义为等效的 XML。

哈希

使用这些函数创建非加密哈希。

hash.FNV32a
返回给定字符串的 32 位 FNV(Fowler–Noll–Vo)非加密哈希值。
hash.XxHash (xxhash)
返回给定字符串的 64 位 xxHash 非加密哈希值。

图像

使用这些函数创建图像滤镜、将图像滤镜应用于图像以及检索图像信息。

images.AutoOrient
返回一个图像过滤器,根据图像的 EXIF 方向标记需要旋转和翻转图像。
images.Brightness
返回一个更改图像亮度的图像过滤器。
images.ColorBalance
返回一个更改图像颜色平衡的图像过滤器。
images.Colorize
返回一个图像过滤器,该过滤器会生成图像的彩色版本。
images.Config
从指定路径(相对于工作目录)的图像返回一个 image.Config 结构体。
images.Contrast
返回一个更改图像对比度的图像过滤器。
images.Dither
返回一个对图像进行抖动的图像过滤器。
images.Filter
将一个或多个图像过滤器应用于给定的图像资源。
images.Gamma
返回一个对图像执行伽马校正的图像滤镜。
images.GaussianBlur
返回一个图像过滤器,该过滤器将高斯模糊应用于图像。
images.Grayscale
返回一个图像过滤器,该过滤器会生成图像的灰度版本。
images.Hue
返回一个旋转图像色相的图像过滤器。
images.Invert
返回一个反转图像颜色的图像过滤器。
images.Opacity
返回一个更改图像不透明度的图像过滤器。
images.Overlay
返回一个图像过滤器,该过滤器将源图像叠加在给定坐标处,相对于左上角。
images.Padding
返回一个图像过滤器,该过滤器调整图像画布大小而不会调整图像大小。
images.Pixelate
返回一个图像过滤器,该过滤器会对图像应用像素化效果。
images.Process
返回一个图像过滤器,使用给定的规范处理给定的图像。
images.Saturation
返回一个更改图像饱和度的图像过滤器。
images.Sepia
返回一个图像过滤器,该过滤器会生成图像的棕褐色版本。
images.Sigmoid
返回一个图像过滤器,该过滤器使用 S 形函数更改图像的对比度。
images.Text
返回一个图像过滤器,用于向图像添加文本。
images.UnsharpMask
返回一个锐化图像的图像过滤器。

图表函数

使用这些函数来渲染图表。

diagrams.Goat
将 ASCII 艺术转换为 SVG 图表,返回一个 GoAT 图表对象。

字符串

使用这些函数来处理字符串。

strings.Chomp (chomp)
返回给定的字符串,移除所有尾部的换行符和回车符。
strings.Contains
报告给定字符串是否包含给定子字符串。
strings.ContainsAny
报告给定字符串是否包含给定集合中的任何字符。
strings.ContainsNonSpace
报告给定字符串是否包含任何Unicode定义的非空格字符。
strings.Count
返回给定字符串中给定子字符串的不重叠实例的数量。
strings.CountRunes (countrunes)
返回给定字符串中排除空格的字符数。
strings.CountWords (countwords)
返回给定字符串中的单词数。
strings.Diff
返回两个文本 OLD 和 NEW 的锚定差异,采用统一 diff 格式。如果 OLD 和 NEW 相同,则返回空字符串。
strings.FindRE (findRE)
返回与正则表达式匹配的字符串切片。
strings.FindRESubmatch (findRESubmatch)
返回正则表达式所有连续匹配项的切片。每个元素都是一个字符串切片,包含正则表达式最左侧匹配项的文本及其子表达式的匹配项(如果有)。
strings.FirstUpper
返回给定的字符串,并将第一个字符大写。
strings.HasPrefix (hasPrefix)
报告给定字符串是否以给定前缀开头。
strings.HasSuffix (hasSuffix)
报告给定字符串是否以给定后缀结尾。
strings.Repeat
返回一个由零个或多个其他字符串副本组成的新字符串。
strings.Replace (replace)
返回 INPUT 的副本,将所有 OLD 替换为 NEW。
strings.ReplaceRE (replaceRE)
返回 INPUT 的副本,将所有正则表达式匹配项替换为替换模式。
strings.RuneCount
返回给定字符串中的符文数。
strings.SliceString (slicestr)
返回给定字符串的子字符串,从起始位置开始,到结束位置之前结束。
strings.Split (split)
通过分隔符分割给定字符串,返回字符串切片。
strings.Substr (substr)
返回给定字符串的子字符串,从起始位置开始,到给定长度之后结束。
strings.Title (title)
返回给定的字符串,将其转换为标题大小写。
strings.ToLower (lower)
返回给定的字符串,并将所有字符转换为小写。
strings.ToUpper (upper)
返回给定的字符串,并将所有字符转换为大写。
strings.Trim (trim)
返回给定的字符串,移除在 cutset 中指定的开头和结尾的字符。
strings.TrimLeft
返回给定的字符串,移除在 cutset 中指定的开头字符。
strings.TrimPrefix
返回给定的字符串,移除字符串开头的前缀。
strings.TrimRight
返回给定的字符串,移除在 cutset 中指定的尾随字符。
strings.TrimSpace
返回给定的字符串,去除Unicode定义的前导和尾随空白字符。
strings.TrimSuffix
返回给定的字符串,移除字符串末尾的后缀。
strings.Truncate (truncate)
返回给定的字符串,将其截断到最大长度,不会截断单词或留下未关闭的 HTML 标签。

安全函数

使用这些函数在 Go 的 html/template 包的上下文中声明一个值是安全的。

safe.CSS (safeCSS)
将给定字符串声明为安全的 CSS 字符串。
safe.HTML (safeHTML)
将给定的字符串声明为安全 HTML 字符串。
safe.HTMLAttr (safeHTMLAttr)
将给定的键值对声明为安全的 HTML 属性。
safe.JS (safeJS)
将给定字符串声明为安全的 JavaScript 表达式。
safe.JSStr (safeJSStr)
将给定字符串声明为安全的 JavaScript 字符串。
safe.URL (safeURL)
将给定字符串声明为安全的 URL 或 URL 子字符串。

局部模板函数

使用这些函数来调用局部模板。

partials.Include (partial)
执行给定的局部模板,可以选择性地传递上下文。如果局部模板包含 return 语句,则返回给定值,否则返回渲染后的输出。
partials.IncludeCached (partialCached)
执行给定的模板并缓存结果,可以选择性地传递上下文。如果局部模板包含return语句,则返回给定值,否则返回渲染后的输出。

数学

使用这些函数执行数学运算。

math.Abs
返回给定数字的绝对值。
math.Acos
返回给定数字的反余弦值(以弧度为单位)。
math.Add (add)
将两个或多个数字相加。
math.Asin
返回给定数字的反正弦值(以弧度为单位)。
math.Atan
返回给定数字的反正切值(以弧度表示)。
math.Atan2
返回给定数字对的反正切值(以弧度为单位),根据其符号确定正确的象限。
math.Ceil
返回大于或等于给定数字的最小整数。
math.Cos
返回给定弧度数的余弦值。
math.Counter
增加并返回一个全局计数器。
math.Div (div)
将第一个数字除以一个或多个数字。
math.Floor
返回小于或等于给定数字的最大整数。
math.Log
返回给定数字的自然对数。
math.Max
返回所有数字中较大的一个。接受标量、切片或两者。
math.Min
返回所有数字中最小的一个。接受标量、切片或两者。
math.Mod (mod)
返回两个整数的模。
math.ModBool (modBool)
报告两个整数的模是否等于 0。
math.Mul (mul)
乘以两个或多个数字。
math.Pi
返回数学常数 π。
math.Pow (pow)
返回第一个数字的第二个数字次幂。
math.Product
返回所有数字的乘积。接受标量、切片或两者。
math.Rand
返回一个位于半开区间 [0.0, 1.0) 内的伪随机数。
math.Round
返回最接近的整数,四舍五入远离零。
math.Sin
返回给定弧度数的正弦值。
math.Sqrt
返回给定数字的平方根。
math.Sub (sub)
从第一个数字中减去一个或多个数字。
math.Sum
返回所有数字的总和。接受标量、切片或两者。
math.Tan
返回给定弧度数的正切值。
math.ToDegrees
ToDegrees 将弧度转换为角度。
math.ToRadians
ToRadians 将度数转换为弧度。

数据

使用这些函数读取本地或远程数据文件。

data.GetCSV (getCSV)
从本地或远程 CSV 文件返回一个数组的数组,如果文件不存在则返回错误。
data.GetJSON (getJSON)
从本地或远程 JSON 文件返回一个 JSON 对象,如果文件不存在则返回错误。

时间

使用这些函数处理时间值。

time.AsTime (time)
将给定的日期/时间值的字符串表示形式返回为 time.Time 值。
time.Duration (duration)
使用给定的时间单位和数字返回一个 time.Duration 值。
time.Format (dateFormat)
将给定的日期/时间作为格式化和本地化的字符串返回。
time.Now (now)
返回当前本地时间。
time.ParseDuration
解析给定的持续时间字符串,返回一个 time.Duration 值。

模板

使用这些函数查询模板系统。

templates.Defer
推迟模板的执行,直到所有站点和输出格式都已渲染完毕。
templates.Exists
报告给定路径下(相对于 layouts 目录)是否存在模板文件。

比较

使用这些函数比较两个或多个值。

compare.Conditional (cond)
根据控制参数的值返回两个参数中的一个。
compare.Default (default)
如果设置了第二个参数,则返回第二个参数;否则返回第一个参数。
compare.Eq (eq)
返回 arg1 == arg2 || arg1 == arg3 的布尔真值。
compare.Ge (ge)
返回 arg1 >= arg2 && arg1 >= arg3 的布尔值真值。
compare.Gt (gt)
返回 arg1 > arg2 && arg1 > arg3 的布尔值真值。
compare.Le (le)
返回 arg1 <= arg2 && arg1 <= arg3 的布尔真值。
compare.Lt (lt)
返回 arg1 < arg2 && arg1 < arg3 的布尔真值。
compare.Ne (ne)
返回 arg1 != arg2 && arg1 != arg3 的布尔真值。

类型转换

使用这些函数将值从一种数据类型转换为另一种数据类型。

cast.ToFloat (float)
将值转换为十进制浮点数(基数 10)。
cast.ToInt (int)
将值转换为十进制整数(基数 10)。
cast.ToString (string)
将值转换为字符串。

编码

使用这些函数来编码和解码数据。

encoding.Base64Decode (base64Decode)
返回给定内容的 Base64 解码结果。
encoding.Base64Encode (base64Encode)
返回给定内容的 Base64 编码结果。
encoding.Jsonify (jsonify)
将给定对象编码为 JSON。

调试

使用这些函数调试你的模板。

debug.Dump
将对象转储为字符串返回。
debug.Timer
创建一个命名计时器,将经过的时间报告到控制台。

资源

使用这些函数来处理资源。

resources.Babel
使用 Babel 编译给定的 JavaScript 资源。
resources.ByType
返回给定媒体类型的全局资源集合,如果未找到则返回 nil。
resources.Concat
返回拼接后的资源切片。
resources.Copy
将给定资源复制到目标路径。
resources.ExecuteAsTemplate
返回一个由 Go 模板创建的资源,该资源使用给定的上下文进行解析和执行。
resources.Fingerprint (fingerprint)
对给定资源的内容进行加密哈希。
resources.FromString
返回根据字符串创建的资源。
resources.Get
从给定路径返回全局资源,如果未找到则返回 nil。
resources.GetMatch
返回与给定 glob 模式匹配的第一个全局资源,如果未找到则返回 nil。
resources.GetRemote
从给定的 URL 返回远程资源,如果未找到则返回 nil。
resources.Match
返回与给定 glob 模式匹配的全局资源集合,如果没有找到则返回 nil。
resources.Minify (minify)
压缩给定的资源。
resources.PostCSS
使用任何 PostCSS 插件使用 PostCSS 处理给定的资源。
resources.PostProcess
构建后处理给定的资源。
resources.ToCSS
将 Sass 编译成 CSS。

路径

使用这些函数处理文件路径。

path.Base
将路径分隔符替换为斜杠( / ),并返回给定路径的最后一个元素。
path.BaseName
将路径分隔符替换为斜杠(/),并返回给定路径的最后一个元素,如果存在扩展名则将其移除。
path.Clean
将路径分隔符替换为斜杠 (/) 并返回与给定路径等效的最短路径名。
path.Dir
将路径分隔符替换为斜杠 (/) 并返回给定路径中除最后一个元素外的所有元素。
path.Ext
将路径分隔符替换为斜杠 (/) 并返回给定路径的文件名扩展名。
path.Join
将路径分隔符替换为斜杠(/),将给定的路径元素连接成单个路径,并返回与结果等效的最短路径名称。
path.Split
将路径分隔符替换为斜杠( / ),然后在最后一个斜杠之后立即分割生成的路径,将其分成目录和文件名组件。

集合

使用这些函数来处理数组、切片、映射和页面集合。

collections.After (after)
切片数组,获取第 N 个元素之后的所有元素。
collections.Append (append)
将一个或多个元素追加到切片并返回结果切片。
collections.Apply (apply)
返回一个新集合,其中每个元素都由给定函数转换。
collections.Complement (complement)
返回最后一个集合中不包含在任何其他集合中的元素。
collections.Delimit (delimit)
循环遍历任何数组、切片或映射,并返回一个由分隔符分隔的所有值的字符串。
collections.Dictionary (dict)
返回由给定的键值对组成的映射。
collections.First (first)
返回给定集合的前 N 个元素。
collections.Group (group)
按给定键对给定的页面集合进行分组。
collections.In (in)
报告给定值是否为给定集合的成员。
collections.Index (index)
返回与给定键或键关联的对象、元素或值。
collections.Intersect (intersect)
返回两个数组或切片的公共元素,顺序与第一个数组相同。
collections.IsSet (isset)
报告键是否存在于集合中。
collections.KeyVals (keyVals)
返回一个 KeyVals 结构体。
collections.Last 函数 (last)
返回给定集合,限制为最后 N 个元素。
collections.Merge (merge)
返回合并两个或多个映射的结果。
collections.NewScratch (newScratch)
返回一个局部作用域的“临时存储区”用于存储和操作数据。
collections.Querify (querify)
返回由给定的键值对组成的 URL 查询字符串,已编码并按键排序。
collections.Reverse
反转集合的顺序。
collections.Seq (seq)
返回一个整数切片。
collections.Shuffle (shuffle)
返回给定数组或切片的随机排列。
collections.Slice (slice)
返回由给定值组成的切片。
collections.Sort (sort)
对切片、映射和页面集合进行排序。
collections.SymDiff (symdiff)
返回两个集合的对称差集。
collections.Union (union)
给定两个数组或切片,返回一个新数组,其中包含属于任一或两个数组/切片的元素。
collections.Uniq (uniq)
返回给定的集合,移除重复元素。
collections.Where (where)
返回给定的集合,移除不满足比较条件的元素。

See also

  • hugo
  • 语言
  • 语言

On this page

  • css
  • fmt
  • go 模板
  • hugo
  • js
  • lang
  • openapi3
  • os
  • urls
  • 全局
  • 加密
  • 反射
  • 变形
  • 变换
  • 哈希
  • 图像
  • 图表函数
  • 字符串
  • 安全函数
  • 局部模板函数
  • 数学
  • 数据
  • 时间
  • 模板
  • 比较
  • 类型转换
  • 编码
  • 调试
  • 资源
  • 路径
  • 集合
Last updated: January 10, 2025: 添加 gtm 谷歌代码管理 (6220bf5)
Improve this page
By the Hugo Authors
Hugo Logo
  • File an Issue
  • Get Help
  • @GoHugoIO
  • @spf13
  • @bepsays
 

Hugo Sponsors

Your Company?
 

The Hugo logos are copyright © Steve Francia 2013–2025.

The Hugo Gopher is based on an original work by Renée French.

  • 新闻
  • 文档
  • 主题
  • 社区
  • GitHub
  • 关于
  • 安装
  • 快速上手
  • 快速参考
  • 内容管理
  • 模板
  • 函数
  • 方法
  • 渲染钩子
  • Hugo 模块
  • Hugo 管道
  • 命令行界面
  • 故障排除
  • 开发者工具
  • 托管和部署
  • 贡献
  • 维护