使用 toshimaru / jekyll-toc 在 jekyll 站点上自定义自动生成的 TOC答案

【问题标题】：Customize automatically generated TOC on jekyll site using toshimaru / jekyll-toc使用 toshimaru / jekyll-toc 在 jekyll 站点上自定义自动生成的 TOC
【发布时间】：2020-09-23 08:27:02
【问题描述】：

我有一个 Jekyll 站点，它使用 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 值。请帮忙

【问题讨论】：

标签： ruby-on-rails ruby rubygems jekyll

【解决方案1】：

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

布局：

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

页面：

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

css:

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

【讨论】：