使用Jekyll和Kramdown的目录

Question

我正试图在我的Jekyll网站上的页面(而不是帖子)上使用Kramdown的自动"目录"生成器.

_includes/toc.html

<nav>
  <h4>Table of Contents</h4>
  {:toc}
</nav>

my_cool_stuff/my_cool_page.md

---
layout: page
---

{% include toc.html %}

# The title of my page
## The Subtitle of my page

HTML是按字面生成的,我没有得到标题列表.

<nav>
  <h4 class="toc_title">On This Page</h4>
  {:toc}
</nav>

我设置错了什么？

Answer 1

{:toc}是自动内容生成表的kramdown标记.

在您的情况下,您需要再做两件事才能使其工作:

1. 允许kramdown在html块中解析:_config.yml添加:

   kramdown:
     parse_block_html: true
   

2. 在_includes/toc.html,您需要提供种子列表:

   <nav>
     <h4>Table of Contents</h4>
     * this unordered seed list will be replaced by toc as unordered list
     {:toc}
   </nav>
   

Answer 2

我想做类似的事情，但试图避免在我的帖子页面中包含任何类型的标记，类似于您的{% include toc.html %}.

我发现了这个很棒的 Ruby Gem - jekyll-toc，它允许您将 TOC 放置在布局文件中的任何位置。您在前面启用它。