jekyll - 是否可以在帖子以外的页面中使用 kramdown 生成目录？如果是这样，如何？

Question

我的 Jekyll 站点上的索引页面就像一个帖子，只有一点额外的代码来导航其他帖子。我并没有真正使用它来生成博客本身，而是一堆新闻页面。

现在在每篇文章中，我都使用 kramdown 来生成一个目录，如下所示:

* This line is a placeholder to generate the table of contents
{:toc}

这适用于所有帖子，但是当我尝试在除帖子之外的任何内容上使用它时，它不会生成。输出只是空的。它没有显示上面的原始 kramdown 或任何东西，它只是消失了，没有任何东西(尤其是不是 TOC)出现在它的位置。

这篇文章的一些评论: How to create a table of contents to Jekyll blog post?

建议放一个 <li>在上面的代码之前，但我尝试了所有可能的迭代，但没有奏效。另一条评论建议使用 <h1>标签是必要的，它存在。

我意识到有一个插件可以生成目录，非 javascript 版本比我所看到的使用 kramdown 的 TOC 实现旧(该插件在这里: https://github.com/dafi/jekyll-toc-generator )。

另一个插件( https://github.com/ghiculescu/jekyll-table-of-contents )更新一些，但我不希望使用 javascript 来做 kramdown 已经可以做的事情。

是否可以使用标准的 kramdown 目录 Markdown 在我的情况下在页面而不是帖子上生成一个？

Answer 1

使用 kramdown 选项无法做到这一点，您也不能使用 {:toc}选项与 {{ content }} Jekyll 页面的原因是 {:toc}不适用于生成的 HTML。

我意识到这是一个较旧的问题，但对于最近偶然发现这个问题的人来说。我写了 a solution to this problem here仅使用 Liquid，因此它可以在 GitHub 页面(不涉及插件)和禁用 JavaScript 的情况下完美运行。我的解决方案适用于 Jekyll 提供的生成的 HTML，因此不需要奇怪的解决方法。

我也意识到“仅链接答案”是不受欢迎的，但我宁愿不必在多个地方维护相同的代码片段。所以我希望你不要介意。