hextra/exampleSite/content/docs/guide/configuration.zh-cn.md

title	weight
配置文件	2

Hugo 从 Hugo 网站根目录下的 hugo.yaml 读取配置. 在配置文件中, 您可以配置站点的所有选项. 你可以在 exampleSite/hugo.yaml 中找到此站点的配置文件作为开始.

Navigation

Menu

右上角的菜单在配置文件的 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

有几种不同类型的菜单项:

1. Link to a page in the site with pageRef

   - name: Documentation
     pageRef: /docs
   

2. Link to an external URL with url

   - name: GitHub
     url: "https://github.com"
   

3. Search bar with type: search

   - name: Search
     params:
       type: search
   

4. 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 中设置 params.editURL:

---
title: Configuration
params:
  editURL: "https://example.com/edit/this/page"
---