[jira] [Updated] (SOLR-10612) make ':toclevels:' work in our jekyll templates

["Cassandra Targett (JIRA)" <ji...@apache.org>]

     [ https://issues.apache.org/jira/browse/SOLR-10612?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Cassandra Targett updated SOLR-10612:
-------------------------------------
    Attachment: lang-analysis-1-level-toc.png

> make ':toclevels:' work in our jekyll templates
> -----------------------------------------------
>
>                 Key: SOLR-10612
>                 URL: https://issues.apache.org/jira/browse/SOLR-10612
>             Project: Solr
>          Issue Type: Sub-task
>      Security Level: Public(Default Security Level. Issues are Public) 
>          Components: documentation
>            Reporter: Hoss Man
>            Assignee: Hoss Man
>         Attachments: lang-analysis-1-level-toc.png
>
>
> 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



--
This message was sent by Atlassian JIRA
(v6.3.15#6346)

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@lucene.apache.org
For additional commands, e-mail: dev-help@lucene.apache.org