[SOLR-10612] make ':toclevels:' work in our jekyll templates

• Type: Sub-task
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Fix Version/s: 6.6, 6.7, 7.0
• Component/s: documentation
• Assignee: Chris M. Hostetter
• Reporter: Chris M. Hostetter
• Created: 05/May/17 18:34
• Updated: 08/Jun/17 23:26
• Resolved: 19/May/17 17:52

Description

asciidoc has a concept called :toclevels: which is suppose to determine which how deep down a page's section/header depth the generated table of contents will show – ie: some LONG pages have a huge number of level 2 headings, and on those pages we only want to show level 1.

but in jekyll, asciidoctor isn't responsible for generating the TOC – instead it's done by some javascript (which is better for a variety of reasons) and at the moment this javascript doesn't know anything about :toclevels:

But it should be possible to tweak our rendering templates to include :toclevels: as an attribute in the generated HTML, and then we can tweak the javascript call made to generate the TOC so that it respects it on a per-page basis