Improve table of contents

- Replace html snippet with _includes/toc.html
- Add FA icon to table of contents header
- Display table of contents on small screens
- Add hierarchy to toc with indents
This commit is contained in:
Michael Rose
2015-01-21 10:16:48 -05:00
parent 3688b97b3c
commit 9a1c5ff3e6
3 changed files with 18 additions and 26 deletions

View File

@ -9,15 +9,7 @@ image:
creditlink: http://wegraphics.net/downloads/free-ultimate-blurred-background-pack/
---
<section id="table-of-contents" class="toc">
<header>
<h3>Overview</h3>
</header>
<div id="drawer" markdown="1">
* Auto generated table of contents
{:toc}
</div>
</section><!-- /#table-of-contents -->
{% include _toc.html %}
## Installation
@ -268,23 +260,12 @@ To assign Billy Rick as an author for our post. We'd add the following YAML fron
author: billy_rick
{% endhighlight %}
### Table of Contents
### Kramdown Table of Contents
Any post or page that you want a *table of contents* to render insert the following HTML in your post before the actual content. [Kramdown will take care of the rest](http://kramdown.rubyforge.org/converter/html.html#toc) and convert all headlines into a contents list.
**PS:** The TOC is hidden on small devices because I haven't gotten around to optimizing it. For now it only appears on larger screens (tablet and desktop).
{: .notice}
To include an auto-generated **table of contents** for posts and pages, add the following `_include` before the actual content. [Kramdown will take care of the rest](http://kramdown.rubyforge.org/converter/html.html#toc) and convert all headlines into list of links.
{% highlight html %}
<section id="table-of-contents" class="toc">
<header>
<h3>Overview</h3>
</header>
<div id="drawer" markdown="1">
* Auto generated table of contents
{:toc}
</div>
</section><!-- /#table-of-contents -->
{% raw %}{% include _toc.html %}{% endraw %}
{% endhighlight %}
### Paragraph Indentation