javascript - 克拉姆当延伸

Question

Kramdown 具有很酷的目录生成功能

{: .toc}

这会生成一个很好的目录，例如 html 中的有序/无序列表:

<ul id="markdown-toc">
   <li></li>
   ...
</ul>

但有时我想对其进行更多控制，例如使用 Bootstrap List Group甚至使用 <div>标记然后 <ul><li></li></ul> .

有没有办法继承/覆盖这个toc生成我自己的标记的模块？

注意:我将 github 页面与 jekyll 一起使用。

Answer 1

不幸的是不是 - {: toc}语法不接受除 toc_levels 之外的任何修改(它允许您指定 toc 深度；有关详细信息，请参阅 the options documentation)。本质上你可以指定 whether you'd like the list to be unordered or ordered取决于你是否使用

* Table of contents
{: toc}

或

1. Table of contents
{: toc}

您还可以使用 {: .no_toc} 排除 header 选项(至少如果您使用 auto-ids ，因为只添加带有 id 的 header ，如果您不使用该选项，您也可以不提供 id):

# Header
{: .no_toc}

任何其他与 CSS、Javascript 或后处理有关的事情。然而，这通常相对简单，因为您可以包装整个 toc在 <div>如果您愿意或将您想要的任何类(class)添加到 <ul>/<ol>附上 toc 。如果您在获取 toc 时遇到困难在您的div内生成，确保您允许 block level parsing或者 parse_block_html全局或 markdown="block"目录本身的选项。例如，

# Header

<div markdown="block" id="xyzzy">
* TOC
{: toc .class}
</div>

应该生成

<h1 id="header">Header</h1>

<div id="xyzzy">
<ul class="class" id="markdown-toc">
  <li><a href="#header" id="markdown-toc-header">Header</a></li>
</ul>

</div>