jekyll - 如何使用 jekyll 和 redcarpet 编写目录

Question

使用 jekyll 2.0.3，我最初配置了 _config.yml

markdown: kramdown

我能够在我的 example.md 中添加如下目录：

---
layout: page
title: Sample
---
{:toc}

## section 1
## section 2

但是，我切换到 redcarpet，请参阅 _config.yml：

markdown: redcarpet
redcarpet:
  extensions: ["no_intra_emphasis", "fenced_code_blocks", "autolink", "strikethrough", "superscript", "with_toc_data"]

现在{:toc:}不起作用。

redcarpet v2.2.2 的文档（由 jekyll 2.0.3 使用）： https ://github.com/vmg/redcarpet/blob/v2.2.2/README.markdown#and-its-like-really-simple-to-采用

提到:with_toc_data，但我不知道在哪里/如何使用它。

如何使用 redcarpet 显示目录？

Answer 1

这里的问题是这:with_toc_data是 redcarpet 渲染器实例的一个选项，而不是配置扩展。

不幸的是，Jekyll 似乎没有公开这个渲染器选项，所以我认为你不能使用它。文档说：

smartJekyll 中不能指定除此之外的任何渲染器选项。

但是您可以改用目录 jekyll 插件。快速搜索会返回许多可用选项，其中一个链接自 Jekyll 官方网站。

Answer 2

也许这应该工作。在_config.yml文件中提及这一点。

markdown: redcarpet
redcarpet:
      extensions: [with_toc_data]

我在我的博客上使用 markdown 以及 JQuery 和 js 文件。这就是它的样子。

这是有关如何操作的详细指南 - Jekyll TOC