本文介紹菜單的屬性和如何設置菜單。
屬性 | 類型 | 描述 |
---|---|---|
name | string | 菜單名稱 |
identifier | string | 菜單標識,一般用於定義多層級菜單。 |
weight | number | 菜單權重,越小優先級越高。 |
parent | string | 父級菜單的標識,也就是 identifier 。 |
url | string | 菜單 URL。 |
pre | string | 菜單的前置字符串。 |
post | string | 菜單的尾部字符串。 |
params | object | 模塊的特定參數。 |
每個菜單集都有其自己的標識,比如 main
、footer
等等,其與對應的模塊相關。
Hugo 支持兩種配置菜單的方式:菜單配置文件和頁面參數(又稱 front matter)。
menus.toml
1[[main]]
2 name = 'Example'
3 url = 'https://example.com'
toml
menus.yaml
1main:
2- name: Example
3 url: https://example.com
yaml
menus.json
1{
2 "main": [
3 {
4 "name": "Example",
5 "url": "https://example.com"
6 }
7 ]
8}
json
其中
main
爲菜單集標識。
當我們打算將某一頁面添加到菜單集,最簡便的方法是於頁面設置的以下參數。
menus.toml
1[menu]
2 [menu.main]
3 weight = 2
toml
menus.yaml
1menu:
2 main:
3 weight: 2
yaml
menus.json
1{
2 "menu": {
3 "main": {
4 "weight": 2
5 }
6 }
7}
json
這種方式不需要顯式地指定菜單的名稱和 URL。