Github Pages如何用jekyll-theme-minimal或易切换主题实现自动目录?
关于Jekyll博客自动生成目录(TOC)的解决方案
能否用jekyll-theme-minimal实现自动TOC?
jekyll-theme-minimal本身没有内置自动生成目录的功能,但你可以通过两种方式手动实现,无需切换主题:
- 利用Jekyll内置的
{% toc %}标签:在你的页面模板文件(比如_layouts/post.html或_layouts/page.html)中添加该标签,同时在需要生成TOC的页面Front Matter里加上toc: true参数。 - 嵌入JavaScript脚本:在模板中添加一段JS代码,页面加载后自动抓取页面内的
h1、h2、h3标签,动态生成目录列表并插入到指定位置,这种方法不需要修改Jekyll配置。
推荐无需大幅修改页面的替代主题
如果不想手动编写代码,以下主题内置自动TOC功能,且与JekyllNow的Markdown语法完全兼容,切换后无需大幅修改现有页面:
- Minimal Mistakes:支持自动生成TOC,只需在页面Front Matter中添加
toc: true即可启用,主题结构与JekyllNow接近,适配Github Pages环境。 - Just the Docs:主打文档类博客场景,内置侧边栏自动TOC,只要文章使用标准的#、##、###层级标题,就能自动识别生成目录,无需额外修改文章内容。
- Chirpy:功能完善的博客主题,支持自动TOC功能,开启配置后即可识别文章内的标题层级生成目录,对现有Markdown页面兼容性极佳。
内容的提问来源于stack exchange,提问作者user93353
相关产品推荐
相关产品推荐

