Custom toc position

[ju-mueller]

Hello again. I added

• The ability to disable the TOC.
• The ability to set a different TOC position in the document. This is useful, when you need e.g. a foreword in before your TOC.

[SteffenL]

The ability to disable the TOC.

ToC does not seem to render if the toc_level option has a value of 0. Haven't tested your code so I don't know if and how that would be different.

[orzih]

Hi ju-mueller.

I've some suggestion.

1. Isn't toc keyword too vague in nav entries?

mkdocs (and document maintainers) might get confused.

WARNING -  A relative path to 'toc' is included in the 'nav' configuration, which is not found in the documentation files

It's better to use a custom scheme like with-pdf:toc - (mkdocs will make Link object).

2. Is toc option needed?

I think it's enough to print a warning message if nav contains a custom scheme and toc_level is 0.

3. About pages before the ToC.

• exclude in ToC.
• headings without ordered.

[ju-mueller]

Thanks for your suggestions. I'll look that I find some time during the next weeks to implement that.