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

2020-06-01 · 大约 300 个字 · 预计 2 分钟读完

前提条件

在 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 格式。