菜单配置

2023年2月17日 1 分钟阅读配置文档菜单

本页内容

本文介绍菜单的属性和如何设置菜单。

菜单项属性

每个菜单集都有其自己的标识，比如 main、footer 等等，其与对应的模块相关。

Hugo 支持两种配置菜单的方式：菜单配置文件和页面参数（又称 front matter）。

menus.toml

1[[main]]
2  name = 'Example'
3  url = 'https://example.com'

menus.yaml

1main:
2- name: Example
3  url: https://example.com

menus.json

1{
2   "main": [
3      {
4         "name": "Example",
5         "url": "https://example.com"
6      }
7   ]
8}

其中 main 为菜单集标识。

当我们打算将某一页面添加到菜单集，最简便的方法是于页面设置的以下参数。

menus.toml

1[menu]
2  [menu.main]
3    weight = 2

menus.yaml

1menu:
2  main:
3    weight: 2

menus.json

1{
2   "menu": {
3      "main": {
4         "weight": 2
5      }
6   }
7}

这种方式不需要显式地指定菜单的名称和 URL。