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 页面集合的快速参考指南。

页面

在渲染 章节 页面、 分类 页面、 术语 页面和主页上的列表时,使用这些 Page 方法。

PAGE.RegularPages
返回当前章节内常规页面的集合。
PAGE.RegularPagesRecursive
返回当前区块内以及所有子区块内的常规页面集合。
PAGE.节区
返回一个节区页面集合,每个页面对应给定页面的每个直接子节区。
PAGE.页面
返回当前章节内常规页面的集合,以及直接子章节的章节页面。

站点

在渲染任何页面上的列表时,使用这些 Site 方法。

SITE.AllPages
返回所有语言中所有页面的集合。
SITE.常规页面
返回所有常规页面的集合。
SITE.节区
返回一级节区页面的集合。
SITE.页面
返回所有页面的集合。

筛选

使用 where 函数来筛选页面集合。

排序

默认情况下,Hugo 按以下顺序对页面集合进行排序:

  1. 权重
  2. 日期 (降序)
  3. 链接标题 (回退到 标题 )
  4. 文件名 (如果页面由文件支持)

使用这些方法对页面集合进行排序。

PAGES.ByDate
返回按日期升序排序的给定页面集合。
PAGES.ByExpiryDate
返回按过期日期升序排序的给定页面集合。
PAGES.ByLanguage
返回按语言升序排序的给定页面集合。
PAGES.ByLastmod
返回按上次修改日期(升序)排序的给定页面集合。
PAGES.ByLength
返回按内容长度升序排序的给定页面集合。
PAGES.ByLinkTitle
返回按链接标题升序排序的给定页面集合,如果未定义链接标题,则回退到标题。
PAGES.ByParam
返回按给定参数升序排序的页面集合。
PAGES.ByPublishDate
返回按发布日期升序排序的给定页面集合。
PAGES.ByTitle
按标题升序返回给定的页面集合。
PAGES.ByWeight
按权重升序返回给定的页面集合。
PAGES.反转
以相反的顺序返回给定的页面集合。

分组

使用这些方法对页面集合进行分组。

PAGES.GroupBy
返回按指定字段(升序)分组的页面集合。
PAGES.GroupByDate
按降序返回按日期分组的给定页面集合。
PAGES.GroupByExpiryDate
返回按失效日期降序分组的给定页面集合。
PAGES.GroupByLastmod
返回按最后修改日期降序排列的给定页面集合分组结果。
PAGES.GroupByParam
按升序返回按给定参数分组的页面集合。
PAGES.GroupByParamDate
返回按给定日期参数(降序)分组的页面集合。
PAGES.GroupByPublishDate
按发布日期降序返回给定的页面集合分组结果。
PAGES.反转
以相反的顺序返回给定的页面集合。

See also

  • 方法
  • Passthrough
  • js.Batch
  • 代码块
  • 内容适配器

On this page

  • 页面
  • 站点
  • 筛选
  • 排序
  • 分组
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 管道
  • 命令行界面
  • 故障排除
  • 开发者工具
  • 托管和部署
  • 贡献
  • 维护