[
https://issues.apache.org/jira/browse/SOLR-10612?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16011367#comment-16011367
]
Cassandra Targett commented on SOLR-10612:
------------------------------------------
I just spent a little bit of time trying to make the native TOC in the
jekyll-asciidoc gem work, and I believe based on what I've read about it that
only two positions for the TOC are supported: preamble (at the top of the page)
and macro (explicitly positioned inline with the page). Any right or left side
placement won't work.
See:
https://github.com/asciidoctor/jekyll-asciidoc#generating-a-table-of-contents
https://github.com/asciidoctor/jekyll-asciidoc/issues/135
http://discuss.asciidoctor.org/Jekyll-Plugin-toc-Problem-td4070.html
But, maybe there is some stuff we could do with JS and/or the liquid template
with a new param and/or CSS. I'm not throwing away the idea, just one of the
obvious ideas probably isn't workable.
> 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: [email protected]
For additional commands, e-mail: [email protected]
