当前标签 / 标题索引 / 总共1篇

Hugo 配置文章内容标题索引导航

前提条件

在 Hugo 0.60.0 后我们可以方便的实现文章内标题索引了,因为从这个版本开始引入了 Goldmark MarkDown 生成引擎,基于该引擎在此版本引入了 TableOfContents 配置。

因此,你在尝试此文章的后续内容的前提是确保你的 Hugo 版本是 0.60.0 以上,查看版本命令如下:

1
2
$ hugo version
Hugo Static Site Generator v0.70.0-7F47B99E windows/amd64 BuildDate: 2020-05-06T11:17:50Z

如果你的 Hugo 版本过低,建议先升级版本。

配置文件

1
2
3
4
5
[markup]
    [markup.tableOfContents] #文章导航设置
        endLevel = 3      #3级标题以后不建立索引
        ordered = false   #是否采用有序列表
        startLevel = 2    #2级标题开始建立索引

在你的配置文件中加入上面配置,这里需要注意的是你的配置文件可能不是 toml 格式的,有可能是 yaml 格式或者 json 格式。

阅读更多