使用toshimaru/jekyll TOC在jekyll网站上自定义自动生成的TOC



我有一个使用https://github.com/toshimaru/jekyll-toc用于右侧导航。在_config.yml中,我有以下设置,可以确保自动生成的目录中只显示<h2>元素。

toc:
min_level: 2 # default: 1
max_level: 2 # default: 6

这很好,但在某些页面上,我也希望在toc中包含<h3>元素。因此,我想在特定情况下将max_level更改为3。这可能吗?我想从模板代码中动态更改max_level值。请帮助

乍一看,该插件似乎不支持每页配置。作为一种变通方法,您可以一直生成三级标题,并使用CSS隐藏它们,除非您在该页面上专门显示它们。相关部分:

布局:

<body class="{{ page.body_class }}">

页码:

---
body_class: has-toc-level-3
---

css:

body:not(.has-toc-level-3) .toc-h3 {
display: none;
}

最新更新