7772313a53
* docs: fix the documentation error about editURL * docs: fix the documentation error about editURL * Update configuration.md * Update configuration.zh-cn.md --------- Co-authored-by: Xin <xin@imfing.com>
2.5 KiB
2.5 KiB
title, weight
| title | weight |
|---|---|
| 配置文件 | 2 |
Hugo 从 Hugo 网站根目录下的 hugo.yaml 读取配置。
在配置文件中，您可以配置站点的所有选项。
你可以在 exampleSite/hugo.yaml 中找到此站点的配置文件作为开始。
导航栏
菜单
右上角的菜单在配置文件的 menu.main 中配置：
menu:
main:
- name: Documentation
pageRef: /docs
weight: 1
- name: Blog
pageRef: /blog
weight: 2
- name: About
pageRef: /about
weight: 3
- name: Search
weight: 4
params:
type: search
- name: GitHub
weight: 5
url: "https://github.com/imfing/hextra"
params:
icon: github
有几种不同类型的菜单项:
- Link to a page in the site with
pageRef- name: Documentation pageRef: /docs - Link to an external URL with
url- name: GitHub url: "https://github.com" - Search bar with
type: search- name: Search params: type: search - Icon
- name: GitHub params: icon: github
这些菜单项可以通过设置 weight 进行排序。
侧边栏
主侧边栏
主侧边栏是自动从 content 目录结构生成的。
有关更多详细信息，转至 目录结构。
额外链接
侧边栏的额外链接在配置文件的 menu.sidebar 部分中配置：
menu:
sidebar:
- name: More
params:
type: separator
weight: 1
- name: "About"
pageRef: "/about"
weight: 2
- name: "Hugo Docs ↗"
url: "https://gohugo.io/documentation/"
weight: 3
右侧边栏
目录
目录是根据内容文件中的标题自动生成的，可以在 front matter 设置 toc：false 来禁用它。
---
title: Configuration
toc: false
---
编辑此页链接
要配置编辑此页链接，我们可以在配置文件中设置 params.editURL.base：
params:
editURL:
base: "https://github.com/your-username/your-repo/edit/main"
将为每个页面自动生成编辑链接。
如需为特定页面设置编辑链接，可以在页面的 front matter 中设置 editURL：
---
title: Configuration
editURL: "https://example.com/edit/this/page"
---