Collapsing ToC and ToC Depth Configuration

[SinisterMinister]

Addresses #14 and then some.

Collapsable ToC

So right now, it defaults to disabled as that's the current implementation. To enable it, you can do so globally by setting extra.collapse_toc to true in your mkdocs.yml like so:

site_name: Nibiru Documentation
pages:
  - Home: index.md
  - Guides:
    - OpenStack Support: guides/openstack-support.md
theme: cinder
extra:
  collapse_toc: true

This will enable it site-wide. You can also use page-specific overrides by adding collapse_toc to the meta section of your page's markdown like so:

collapse_toc: true

# OpenStack Support
<small>Author: Codey Whitt</small>

## Differences Between AWS and OpenStack

There are only a handful of differences that could potentially cause you headaches while working with OpenStack instances and they are mostly edge cases. We'll start with the only one that isn't.

This way you can enable/disable it site-wide as well as override it on a page by page basis. You can have it enabled site-wide and disabled on individual pages or have it disabled site-wide and enabled individually as well.

Tunable ToC Depth

The other thing I added since I needed more levels in my ToC was the ability to tune the number of levels shown in the ToC. I used the same pattern as before with the ToC collapsing as well. Here it is via mkdocs.yml:

site_name: Nibiru Documentation
pages:
  - Home: index.md
  - Guides:
    - OpenStack Support: guides/openstack-support.md
theme: cinder
extra:
  toc_depth: 4

And here it is on a page level:

toc_depth: 2

# OpenStack Support
<small>Author: Codey Whitt</small>

## Differences Between AWS and OpenStack

There are only a handful of differences that could potentially cause you headaches while working with OpenStack instances and they are mostly edge cases. We'll start with the only one that isn't.

[SinisterMinister]

So, the screenshots won't look right until #16 is merged in. Once it is, things will look right.

[gokr]

Just wanted to mention that I want this stuff too! My doc is also too long ... http://www.sprylang.org

[chrissimpkins]

Thanks for all of this work! Will require a rebase on the changes made to support MkDocs project changes in order to merge this. Feel free to reopen if you are able to do this work. Sorry...