页面前调配置

页面前调配置

每个 Hugo 页面都必须在 toml, yaml 或 json 中定义一个 前言.本网站在所有情况下都将使用 toml.

重新学习主题在雨果主题之上使用以下参数：

+++
# 目录 （toc） 默认处于启用状态。将此参数设置为 true 可禁用它。
# 注意：章节页面始终禁用目录
disableToc = false
# 如果设置，这将用于页面的菜单项（而不是`title`属性）
linktitle = ""
# 如果设置，这将显式覆盖页面菜单项展开状态的通用规则
alwaysopen = true
# 如果设置，这将显式覆盖页面子菜单条目排序顺序的通用规则
ordersectionsby = "title"
# 页面标题的标题将以此 HTML 内容为前缀
headingPre = ""
# 页面标题的标题将在此 HTML 内容后缀
headingPost = ""
# 菜单中页面的标题将以此 HTML 内容为前缀
menuPre = ""
# 菜单中页面的标题将在此 HTML 内容中后缀
menuPost = ""
# 通过将其设置为 true 来隐藏菜单项
hidden = false
# 此页面修饰符的显示名称。如果设置，它将显示在页脚中。
LastModifierDisplayName = ""
# 此页面修改器的电子邮件。如果使用 LastModifierDisplayName 设置，它将显示在页脚中
LastModifierEmail = ""
# 覆盖图片效果的默认值，甚至可以将自己的任意效果添加到列表中
[params.imageEffects]
  border = false
  lightbox = true
  shadow = false
+++

向菜单项添加ICON

在页面首页中，添加一个 menuPre 参数以在菜单标签之前插入任何 HTML 代码。下面的示例使用 GitHub 图标。

+++
title = "Demo Page"
menuPre = "<i class='fas fa-cubes'></i>"
+++

demo page demo page

排序同级菜单/页面条目

Hugo 提供了一种 灵活的方式 来处理页面的顺序。

最简单的方法是设置一个 weight 参数,然后配置为数字.

+++
title = "My page"
weight = 5
+++

对菜单项使用自定义标题

默认情况下，Relearn主题 将使用页面的 title 属性作为菜单项 (如果已定义，则为 linkTitle ).

但是页面的标题必须本身是描述性的，而菜单是一个层次结构。 为此，我们添加了 linktitle 参数:

例如: (名为 content/install/linux.md的页面):

+++
linktitle = "Linux"
title = "Install on Linux"
+++

覆盖菜单项的展开状态规则

您可以使用 alwaysopen - 始终打开 设置按页面更改主题在内容一侧展开菜单条目的方式。如果任何给定条目的 alwaysopen=false 只要为了导航而不需要，其子项就不会显示在菜单中。

主题根据以下规则生成菜单：

  • 无论任何设置如何，都会显示活动页面的所有父条目，包括其同级
  • 无论任何设置如何，都会显示活动页面的直接子条目
  • 如果未被覆盖，所有其他一级条目的行为就像它们被赋予 alwaysopen=false 一样
  • 如果未被覆盖，则除第一个级别之外的所有其他级别条目的行为就像它们被赋予 alwaysopen=true 一样
  • 如果 alwaysopen=true ; 则所有可见条目都显示其直接子条目;这将递归进行
  • 未显示所有剩余条目

您可以在 简码-子 及其子页面的示例页面上看到此功能的实际效果。