web-dev-qa-db-ja.com

JekyllとKramdownを使用した目次

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>

何が間違っているのですか？

jekyllkramdown
13
Devin

{：toc}は 自動目次生成用のkramdownタグ です。

あなたの場合、それを機能させるにはさらに2つのことが必要です。

  1. Kramdownがhtmlブロック内を解析できるようにします：in _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>
18
David Jacquel

私はやりたかった 似たようなもの しかし、あなたの{% include toc.html %}に似た、私の投稿ページにどんな種類のマークアップも持たないようにしようとしていました。

私はこの素晴らしいRuby Gem -- jekyll-toc で、目次をレイアウトファイルのどこにでも配置できることを発見しました。前もって有効にします。

2
sansSpoon