HUGO

  • 新闻
  • 文档
  • 主题
  • 社区
  • GitHub
gohugoio 加星
  • 关于
    • 本节内容
    • 介绍
    • 特性
    • 隐私
    • 安全
    • 许可证
  • 安装
    • 本节内容
    • macOS
    • Linux
    • Windows
    • BSD
  • 入门
    • 本节内容
    • 快速开始
    • 基本用法
    • 目录结构
    • 配置
    • 配置标记
    • 配置构建
    • 术语表
    • 外部学习资源
  • 快速参考
    • 本节内容
    • 表情符号
    • 函数
    • 方法
    • 页面集合
  • 内容管理
    • 本节内容
    • 组织
    • 页面包
    • 内容格式
    • 前言
    • 构建选项
    • 页面资源
    • 图像处理
    • 短代码
    • 相关内容
    • 章节
    • 内容类型
    • 原型
    • 分类法
    • 摘要
    • 链接和交叉引用
    • URL 管理
    • 菜单
    • 评论
    • 多语言
    • Markdown 属性
    • 语法高亮
    • 图表
    • 数学
    • 数据源
    • 内容适配器
  • 模板
    • 本节内容
    • 介绍
    • 模板类型
    • 查找顺序
    • 基础模板
    • 主页模板
    • 单页模板
    • 章节模板
    • 分类模板
    • 术语模板
    • 局部模板
    • 内容视图模板
    • 短代码模板
    • 站点地图模板
    • RSS 模板
    • 404 模板
    • robots.txt 模板
    • 菜单
    • 分页
    • 嵌入式模板
    • 自定义输出格式
  • 函数
    • 本节内容
    • cast
    • collections
    • compare
    • crypto
    • css
    • data
    • debug
    • diagrams
    • encoding
    • fmt
    • global
    • go template
    • hash
    • hugo
    • images
    • inflect
    • js
    • lang
    • math
    • openapi3
    • os
    • partials
    • path
    • reflect
    • resources
    • safe
    • strings
    • templates
    • time
    • transform
    • urls
  • 方法
    • 本节内容
    • Duration
    • Menu
    • Menu entry
    • Page
    • Pager
    • Pages
    • Resource
    • Shortcode
    • Site
    • Taxonomy
    • Time
  • 渲染钩子
    • 本节内容
    • 介绍
    • 引用块
    • 代码块
    • 标题
    • 图像
    • 链接
    • 透传
    • 表格
  • 短代码
    • 本节内容
    • 评论
    • 详情
    • 图
    • Gist
    • 高亮
    • Instagram
    • 参数
    • QR
    • Ref
    • Relref
    • Vimeo
    • X
    • YouTube
  • Hugo 模块
    • 本节内容
    • 配置 Hugo 模块
    • 使用 Hugo 模块
    • 主题组件
  • Hugo Pipes
    • 本节内容
    • 介绍
    • 将 Sass 转译为 CSS
    • PostCSS
    • 后处理
    • JavaScript 构建
    • 资源最小化
    • 连接资源
    • 指纹识别和 SRI 哈希
    • 从字符串创建资源
    • 从模板创建资源
  • CLI
  • 故障排除
    • 本节内容
    • 审计
    • 日志记录
    • 检查
    • 弃用
    • 性能
    • 常见问题解答
  • 开发者工具
    • 本节内容
    • 编辑器插件
    • 前端
    • 搜索
    • 迁移
    • 其他项目
  • 托管和部署
    • 本节内容
    • Hugo Deploy
    • 使用 Rclone 部署
    • 使用 Rsync 部署
    • 在 21YunBox 上托管
    • 在 AWS Amplify 上托管
    • 在 Azure Static Web Apps 上托管
    • 在 Cloudflare Pages 上托管
    • 在 Firebase 上托管
    • 在 GitHub Pages 上托管
    • 在 GitLab Pages 上托管
    • 在 KeyCDN 上托管
    • 在 Netlify 上托管
    • 在 Render 上托管
  • 贡献
    • 本节内容
    • 开发
    • 文档
    • 主题
  • 维护
快速参考

页面集合

Hugo 页面集合的快速参考指南。

页面

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

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

站点

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

SITE.AllPages
返回所有语言的所有页面的集合。
SITE.Pages
返回所有页面的集合。
SITE.RegularPages
返回所有常规页面的集合。
SITE.Sections
返回第一级章节页面的集合。

筛选

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

排序

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

  1. 权重
  2. 按降序排列的日期
  3. LinkTitle,如果未定义,则回退到Title
  4. 如果页面由文件支持,则为文件名

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

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

分组

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

PAGES.GroupBy
返回按给定字段升序分组的给定页面集合。
PAGES.GroupByDate
返回按日期降序分组的给定页面集合。
PAGES.GroupByExpiryDate
返回按过期日期降序分组的给定页面集合。
PAGES.GroupByLastmod
返回按上次修改日期降序分组的给定页面集合。
PAGES.GroupByParam
返回按给定参数升序分组的给定页面集合。
PAGES.GroupByParamDate
返回按给定日期参数降序分组的给定页面集合。
PAGES.GroupByPublishDate
返回按发布日期降序分组的给定页面集合。
PAGES.Reverse
按相反的顺序返回给定的页面集合。

另请参阅

  • 方法
  • 引用块
  • 代码块
  • 配置
  • 内容适配器

本页内容

  • Page
  • Site
  • 筛选
  • 排序
  • 分组
上次更新时间:2024 年 6 月 25 日:重构模板部分 (748bf065f)
改进此页面
由 Hugo 作者提供
Hugo Logo
  • 提交问题
  • 获取帮助
  • @GoHugoIO
  • @spf13
  • @bepsays

Netlify badge

 

Hugo 赞助商

您的公司?
 

Hugo 徽标的版权为 © Steve Francia 2013–2025。

Hugo Gopher 基于 Renée French 的原创作品。

  • 新闻
  • 文档
  • 主题
  • 社区
  • GitHub
  • 关于
  • 安装
  • 入门
  • 快速参考
  • 内容管理
  • 模板
  • 函数
  • 方法
  • 渲染钩子
  • 短代码
  • Hugo 模块
  • Hugo Pipes
  • CLI
  • 故障排除
  • 开发者工具
  • 托管和部署
  • 贡献
  • 维护