目的

GitHub Pages で、jekyll の各記事に目次を追加します。

今回は下記リポジトリを利用します。

• allejo/jekyll-toc: A GitHub Pages compatible Table of Contents generator without a plugin or JavaScript

方法

1. 最新の toc.html ファイルをダウンロードします

2. _includes に 1. でダウンロードしたtoc.htmlファイルを配置します

3. テンプレートファイルに記述

下記のように指定します。content は目次を生成したい html になります。

{% raw >}}

{% include toc.html html=content >}}

{% endraw >}}

Use it in your template layout where you have {% raw >}}{{ content }}{% endraw >}} which is the HTML rendered from the markdown source with this liquid tag: