Menu 方法 on Hugo 中文文档

ByName

Fri, 02 Oct 2026 00:00:00 +0800

Sort 方法返回给定菜单，其条目按 name 排序。

请看下面的菜单定义：

[[menus.main]]
name = 'Services'
pageRef = '/services'
weight = 10

[[menus.main]]
name = 'About'
pageRef = '/about'
weight = 20

[[menus.main]]
name = 'Contact'
pageRef = '/contact'
weight = 30

要按 name 排序条目：

<ul>
  {{ range .Site.Menus.main.ByName }}
    <li><a href="{{ .URL }}">{{ .Name }}</a></li>
  {{ end }}
</ul>

Hugo 渲染结果为：

<ul>
  <li><a href="/about/">About</a></li>
  <li><a href="/contact">Contact</a></li>
  <li><a href="/services/">Services</a></li>
</ul>

也可以使用 sort 函数对菜单条目排序。例如按 name 降序排序：

ByWeight

Fri, 02 Oct 2026 00:00:00 +0800

ByWeight 方法返回给定菜单，其条目先按 weight、再按 name、最后按 identifier 排序。这是默认的排序方式。

请看下面的菜单定义：

[[menus.main]]
identifier = 'about'
name = 'About'
pageRef = '/about'
weight = 20

[[menus.main]]
identifier = 'services'
name = 'Services'
pageRef = '/services'
weight = 10

[[menus.main]]
identifier = 'contact'
name = 'Contact'
pageRef = '/contact'
weight = 30

要按 weight、再按 name、最后按 identifier 排序条目：

Limit

Fri, 02 Oct 2026 00:00:00 +0800

Limit 方法返回给定菜单，并限制为前 N 个条目。

请看下面的菜单定义：

[[menus.main]]
name = 'Services'
pageRef = '/services'
weight = 10

[[menus.main]]
name = 'About'
pageRef = '/about'
weight = 20

[[menus.main]]
name = 'Contact'
pageRef = '/contact'
weight = 30

要按 name 排序条目，并限制为前 2 个：

<ul>
  {{ range .Site.Menus.main.ByName.Limit 2 }}
    <li><a href="{{ .URL }}">{{ .Name }}</a></li>
  {{ end }}
</ul>

Hugo 渲染结果为：

Reverse

Fri, 02 Oct 2026 00:00:00 +0800

Reverse 方法返回给定菜单，并反转其条目的排序顺序。

请看下面的菜单定义：

[[menus.main]]
name = 'Services'
pageRef = '/services'
weight = 10

[[menus.main]]
name = 'About'
pageRef = '/about'
weight = 20

[[menus.main]]
name = 'Contact'
pageRef = '/contact'
weight = 30

要按 name 降序排序条目：

<ul>
  {{ range .Site.Menus.main.ByName.Reverse }}
    <li><a href="{{ .URL }}">{{ .Name }}</a></li>
  {{ end }}
</ul>

Hugo 渲染结果为：