Octopressで見出しタグを目次にする方法

jekyll-toc-generatorというプラグインが使えますが、Octopressで使うと、ちょっとだけ不都合があったので、変更しました。

https://github.com/syui/jekyll-toc-generator

$ echo "gem 'nokogiri'" >> ~/octopress/Gemfile

$ cd ~/octopress

$ bundle install

$ cd ~/octopress/plugins/

$ curl -O https://raw.githubusercontent.com/syui/jekyll-toc-generator/master/_plugins/tocGenerator.rb

あとは、個別ページやメインページなど表示したい場所で{{ content }}を{{ content | toc_generate }}に変更します。

source/_includes/article.html

- <div class="entry-content">{{ content }}</div>

+ <div class="entry-content">{{ content | toc_generate }}</div>

なお、有効無効の設定は、noToc: trueのオプションになります。デフォルトでは有効なので、無効にする設定です。

---
layout: post
noToc: true
---

これで、目次が自動形成されていい感じです。

参考:

Octopressで見出しの目次を作る方法 改 - 割り箸ポテチ