HUGO文章目录BUG

最近有个朋友向我问起一个关于文章目录树的问题,他使用的博客程序是HUGO,他说他下载的主题已经带有文章目录这个功能了,可不知为什么只会显示H2、H3这两级的目录,后面的H4、H5、H6直接隐藏了,根本就不能显示,由于我没有使用过HUGO这个系统,所以一时半会真不能为他解答。

因为他说能显示H2、H3这两级,那说明主题构建的文章目录这个功能是没有问题的,肯定是因为某个设置才导致其他级别的标题出错,去官网查询了下,还真让我发现了问题所在。

导致我朋友这个问题的出现应该是因为HUGO在0.60版本更新时更换了渲染器,然而他使用的主题又没有对此进行相应的更新与说明。话说现在都已经0.80版本了,问题居然还在,看来用HUGO的人还是相对少了点。根据官网的提示,我们只需在配置文件里添加以下代码即可解决。

config.toml添加

1
2
3
4
5
[markup]
[markup.tableOfContents]
endLevel = 3
ordered = false
startLevel = 2

代码中startLevel = 2的意思从H2开始,endLevel = 3到H3结束。所以这里要按自己的需求来修改即可。